Редактор таблицы данных
Компонент "Редактор таблицы данных" предназначен для просмотра и редактирования табличных данных (таблиц данных). |
|
Более подробную информацию о внешнем виде и поведении данного компонента см. здесь.
Компонент "Редактор таблицы данных" выглядит следующим образом:
Общие свойства
Ширина, Высота, Привязки, Активный, Видимый, Рамка
Пользовательские свойства
Тулбар
Контролирует отображение тулбара Редактора таблицы данных.
Имя свойства: toolbar
Тип свойства: Boolean
Разрешить вертикальный режим
Если включен, то позволяет редактору перейти в вертикальный (с одной записью) режим, если формат таблицы имеет как минимальное, так и макимальное количество записей, выставленных на один.
Имя свойства: allowVerticalMode
Тип свойства: Boolean
Включить всплывающие подсказки
Контролирует отображение всплывающих подсказок Редактора таблицы данных.
Имя свойства: enableTooltips
Тип свойства: Boolean
Включить контекстное меню
Контролирует отображение контекстного меню Редактора таблицы данных.
Имя свойства: enablePopupMenu
Тип свойства: Boolean
Отображать метаданные
Контролирует отображение метаданных Редактора таблицы данных.
Имя свойства: showMetadata
Тип свойства: Boolean
Постоянный формат
Определяет, должен ли Редактор таблицы данных принимать только таблицы заранее установленного формата. Если эта опция включена, возможно редактировать свойство Формат (см. ниже) и после определения формата таблицы заполнить таблицу заранее определенными данными путем редактирования свойства Таблица данных (также описана ниже).
 | В момент включения этого флага данные в свойстве Таблица данных конвертируются, чтобы соответствовать данному значению Формата. |
Имя свойства: fixedFormat
Тип свойства: Boolean
Формат
Позволяет указать постоянный формат таблицы, чтобы можно было его просматривать/редактировать в Редакторе Таблицы Данных. Смотрите описание опций формата и отдельные опции поля в разделе Формат таблицы данных.
| В момент, когда меняется Формат, данные в свойстве Таблица данных конвертируются, чтобы соответствовать новому формату. |
Имя свойства: format
Тип свойства: Data Table
Таблица данных
Таблица данных по умолчанию, отображаемая и редактируемая этим компонентом.
| Когда знчение этой опции меняется на новую Таблицу данных, система преобразует данную таблицу, чтобы она соответствовала свойству Формат (это происходит только если флажок устновлен на Фиксированный формат). |
Имя свойства: dataTable
Тип свойства: Data Table
Видимость горизонтальных линий сетки
Активирует отображение горизонтальных линий сетки.
Имя свойства: showHorizontalGrid
Тип свойства: Boolean
Видимость вертикальных линий сетки
Активирует отображение вертикальных линий сетки.
Имя свойства: showVerticalGrid
Тип свойства: Boolean
Свойства заголовка таблицы
Определяет видимость и перенос строк заголовка таблицы, а также его основной цвет и цвета фона.
Имя свойства: headerProperties
Тип свойства: Data Table
Перенос строк
Определяет пепенос строк в ячейках таблицы.
Имя свойства: lineWrap
Тип свойства: Boolean
Отображать номера записей
Определяет видимость столбца с номерами записей.
Имя свойства: showRecordNumbers
Тип свойства: Boolean
Цвет выбранного ряда
Определяет пользовательский цвет для выбранных рядов.
Имя свойства: selectedRowTable
Тип свойства: Data Table
Выражение обработки добавленной записи
Выражение, вычисляемое для обработки каждой новой записи таблицы. Используется при выполнении функции Обработать изменения. Для более подробной информации см. раздел документации о функции Обработать изменения.
Имя свойства: addedRecordProcessingExpression
Тип свойства: String
Выражение обработки измененной записи
Выражение, вычисляемое для обработки каждой измененной записи таблицы. Используется при выполнении функции Обработать изменения. Для более подробной информации см. раздел документации о функции Обработать изменения.
Имя свойства: changedRecordProcessingExpression
Тип свойства: String
Выражение обработки удаленной записи
Выражение, вычисляемое для обработки записей, удаленных из таблицы. Используется при выполнении функции Обработать изменения. Для более подробной информации см. раздел документации о функции Обработать изменения.
| Записи, обрабатываемые при помощи данного выражения, не видны в таблице. Они хранятся во внутреннем списке удаленных записей. |
Имя свойства: removedRecordProcessingExpression
Тип свойства: String
Общие события
Скрытие, Показ, Перемещение, Изменение размеров
Пользовательские функции
Обработать изменения
Функция не имеет входных параметров. Она дает команду редактору таблиц обработать внутренний список добавленных, измененных или удаленных записей:
- Для каждой добавленной записи (даже если позднее она была изменена), вычисляется Выражение обработки добавленной записи. Если выражение возвращает иные значения, кроме false, внутренний флажок записи "новая запись" убирается. Выражение может, например, вызывать функцию Выполнить запрос аккаунта устройства SQL базы данных на стороне сервера, чтобы произвести INSERT новой записи в произвольную базу данных.
- Для каждой измененной записи, вычисляется Выражение обработки измененной записи. Если выражение возвращает иные значения, кроме false, внутренний флажок записи "измененная запись" убирается. Выражение может, например, выполнить UPDATE запрос для внешней базы данных, подключенной к SberMobile Server через драйвер устройства SQL базы данных.
- Для каждой удаленной записи (за исключением записей, которые были предварительно добавлены в сам Редактор таблиц данных), вычисляется Выражение обработки удаленной записи. Если выражение возвращает иные значения, кроме false, запись исключается из внутреннего списка удаленных записей. Выражение может, например, выполнить DELETE-запрос для внешней базы данных, чтобы удалить запись базы данных с ключом, взятым из данных записи.
Added/Changed/Removed Record Processing Expression Среда вычисления Выражения обработки добавленной/измененной/удаленной записи: | |
Контекст по умолчанию виджета. | |
Добавленная/измененная/удаленная обрабатываемая запись. Запись помещается в таблицу с одной ячейкой. Обратите внимание, что таблица по умолчанию НЕ является целой таблицей, хранящейся в Редакторе таблиц данных. | |
0 | |
Только стандартные переменные. |
 | Связанный самоучитель: |
Имя функции: processChanges
Пользовательские события
Выбор строки
Это событие формируется, когда выбираются или не выбираются какие-либо строки таблицы.
Имя события: rowSelection
Поля события:
Поле | Имя | Тип | Описание |
Is Adjusting | isAdjusting | Boolean | Возвращает одно событие из серии множества событий, в которых все еще происходят изменения. |
First Row | firstRow | Integer | Индекс первой строки, чей выбор мог измениться. |
Last Row | lastRow | Integer | Индекс последней строки, чей выбор мог измениться. |
First Record | firstRecord | Integer | Индекс первой строки записи Таблица данных, чей выбор мог измениться. Может отличаться от Первой Строки из-за сортировки, фильтрации, группировки таблицы и т.д. |
Last Record | lastRecord | Integer | Индекс последней строки записи Таблица данных, чей выбор мог измениться. Может отличаться от Последней Строки из-за сортировки, фильтрации, группировки таблицы и т.д. |
Selection | selection | Data Table | Список выбираемых строк, с двумя полями:
|
Кликнута ссылка
Это событие возникает при клике на ссылку в таблице.
Имя события: referenceClicked
Поля события:
Поле | Имя | Тип | Описание |
Reference | reference | String | Возвращает выполненную ссылку. |
Field | field | String | Возвращает имя поля ячейки, где помещалась ссылка. |
Record | record | Integer | Возвращает номер записи ячейки с выполненной ссылкой. |
Data | data | Data Table | Возвращает значение ячейки с запущенной ссылкой. |