Электронная таблица
Компонент Электронная таблица предоставляет интерактивный интерфейс для просмотра и редактирования данных электронной таблицы в инструментальных панелях. |
Электронная таблица позволяет пользователям работать со значениями, формулами, форматированием и стилями, комментариями, сгруппированными строками или столбцами, а также с условным форматированием в рамках одного представления таблицы.
Электронная таблица не является изолированным компонентом инструментальной панели. Она опирается на модель, которая хранит данные электронной таблицы, вычисляет выражения и синхронизирует изменения между пользователями. Компонент инструментальной панели служит пользовательским интерфейсом, а модель обеспечивает базовое состояние электронной таблицы и логику обработки.
В зависимости от типа модели электронная таблица может существовать в разных контекстах. В абсолютной модели одна электронная таблица используется во всей системе. В экземплярной модели каждый экземпляр может иметь свои собственные электронные таблицы. В относительной модели электронные таблицы могут быть связаны с относительными объектами, такими как устройства, пользователи или другие сущности.
Ячейки электронной таблицы могут ссылаться на данные платформы с помощью синтаксиса стандартных ссылок. Эти ссылки используются внутри выражений, которые работают как классические формулы таблицы. Это позволяет использовать электронную таблицу не только в качестве визуальной таблицы, но и в качестве интерфейса для просмотра и редактирования значений из переменных модели и других доступных контекстов.
Сессия таблицы
Когда открывается инструментальная панель, содержащая компонент Электронная таблица, система извлекает определение электронной таблицы из модели, создает сессию электронной таблицы и отображает электронную таблицу на инструментальной панели.
Сессия электронной таблицы представляет собой состояние электронной таблицы во время взаимодействия с пользователем. Она может содержать временные изменения, внесенные пользователем, вычисленные выражения и другие промежуточные данные, необходимые при открытой электронной таблице. Может существовать несколько сессий электронной таблицы одновременно, когда несколько пользователей работают с одной и той же электронной таблицей.
Ячейки и диапазоны
Операции с электронной таблицей могут касаться как отдельных ячеек, так и прямоугольных диапазонов ячеек.
Операции с ячейками используются для работы с конкретным содержимым ячейки, таким как значения, выражения, стили, форматы или комментарии. Операции с диапазонами используются для действий, которые применяются к прямоугольным областям электронной таблицы, таких как очистка ячеек, объединение ячеек, разъединение ячеек или пересчет формул для выбранной области.
Структура ячейки
Ячейка электронной таблицы может содержать несколько независимых слоев информации.
Слой | Описание |
|---|---|
Значение или Ошибка | Текущее значение, хранящееся в ячейке. Если при вычислении ячейки возникает ошибка, ячейка содержит информацию об ошибке, включая тип ошибки и сообщение об ошибке. |
Выражение | Выражение — это формула электронной таблицы, используемая для вычисления значения ячейки. |
Формат | Формат, примененный к значению ячейки. |
Стиль | Визуальный стиль ячейки. |
Комментарии | Пользовательские комментарии, прикрепленные к ячейке. |
Различные функции электронной таблицы изменяют разные слои ячейки.
Ячейка может содержать либо прямое значение, либо выражение. Выражение вычисляет значение ячейки на основе других ячеек, функций электронной таблицы и других частей единой модели данных. При изменении значения движок электронной таблицы пересчитывает зависимые формулы.
В компоненте Электронная таблица вводите выражения в строку формул над сеткой таблицы, а не непосредственно в ячейки. Выражения работают как классические формулы таблицы, но в отличие от традиционных приложений для работы с таблицами, выражения не требуют префикса =.
Пример: sum(A1, B1)
Общие переменные (Свойства)
[?]
Компонент Электронная таблица имеет следующие основные свойства и группы свойств, общие для всех компонентов:
Имя, Дополнительные свойства, Свойства контейнера, Стили, Прелоадер, События, Привязки, Кебаб меню.
Наследуемые переменные (Свойства)
Компонент Электронная таблица внутренне основан на компоненте Таблица данных, поэтому он наследует его общие свойства.
Пользовательские переменные (Свойства)
Электронная таблица
Это свойство определяет параметры электронной таблицы, управляемой данным компонентом.
Название переменной: | spreadsheetParameters |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Описание поля |
modelContextPath | String | Путь к контексту модели, в котором хранится таблица. |
name | String | Название таблицы. |
ranges | Data Table | Определяет диапазоны электронной таблицы. |
savingMode | Integer ( | Определяет способ сохранения изменений в электронной таблице. Поддерживаемые значения:
Когда сохранение отключено, при каждом открытии компонента создается новая копия электронной таблицы. Изменения, внесенные в одну копию одной и той же таблицы, не влияют на другие копии. |
evaluateOnOpen | Boolean | Указывает, будут ли формулы ячеек и условные привязки (пере)вычисляться когда таблица открывается. |
nameSuffix | String ( | Суффикс, добавляемый к имени электронной таблицы, когда |
concurrentEditing | Boolean | Указывает, могут ли несколько пользователей одновременно редактировать электронную таблицу. |
Максимальный уровень прав
Это свойство определяет максимальный уровень прав доступа, доступный в компоненте Электронная таблица. Если у пользователя в системе установлен более высокий уровень прав доступа, то эффективный уровень прав доступа в компоненте Электронная таблица ограничивается этим значением, и доступными остаются только те операции, которые разрешены данным эффективным уровнем.
Название переменной: | maximumPermissionLevel |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Описание поля |
maximumPermissionLevel | String | Определяет максимальный уровень прав доступа, доступный в электронной таблице. Если у пользователя в системе установлен более высокий уровень прав доступа, эффективный уровень прав доступа в электронной таблице ограничивается этим значением. |
Выбранные диапазоны
Это свойство определяет выбранную ячейку или диапазон ячеек в электронной таблице. Оно используется для установки положения по умолчанию при открытии электронной таблицы и для отслеживания ячейки или диапазона, на которых в данный момент находится фокус пользователя.
Название переменной: | selectedRanges |
Записи: | 0…Не ограничено количество |
Формат записи:
Имя поля | Тип поля | Описание поля |
startRowIndex | Integer | Определяет индекс первой строки в выбранном диапазоне, начиная с нуля. |
endRowIndex | Integer | Определяет индекс (с нулевой отсчёткой) последней строки в выбранном диапазоне. |
startColumnIndex | Integer | Определяет индекс с нулевой отсчёткой первого столбца в выбранном диапазоне. |
endColumnIndex | Integer | Определяет индекс (с нулевой отсчёткой) последнего столбца в выбранном диапазоне. |
LazyLoad
Включает режим отложенной загрузки. Когда режим включен, данные электронной таблицы загружаются по запросу, а не все сразу при открытии компонента. Это может повысить производительность при работе с большими таблицами.
Название переменной: | lazyLoad |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Описание поля |
lazyLoad | Boolean | Включает или отключает режим отложенной загрузки. |
Was this page helpful?