Виджет "Сетка" (унаследованный)
Виджет "Сетка" позволяет показывать любой набор данных в представлении сетки. Сетка поддерживает много различных способов представлять данные, в том числе цветовое представление контекста по столбцам и представление изображений в ячейке. Можно настраивать основные параметры представления, в том числе порядок столбцов, видимость столбцов, заголовки столбцов и форматирование состояний, в диалоговом окне конфигурации виджета сетки, выбрав Configure Grid Columns.
Сетка поддерживает изменение размеров столбца в среде времени выполнения, а также менять сортировку данных, щелкая заголовки столбцов.
Редактируемая сетка
Сетка также имеет специальную настройку для виджета и внутреннюю опцию Configure Grid Columns, которая позволяет изменять строки и столбцы в сетке. Это позволяет править значения в сетке, а затем возвращать все ее содержимое в сервис. Или если в сетке отображается Selected Row, возвращаться может конкретная строка. Рекомендуется использовать опцию Selected Row, потому что большие размеры таблицы могут повлиять на использование памяти.
 |
Стили и общие свойства виджетов не включены в приведенную ниже таблицу.
|
|
Имя свойства
|
Описание
|
Базовый тип
|
Значение по умолчанию
|
Доступно для привязки? (Д/Н)
|
Доступно для локализации? (Д/Н)
|
||
|---|---|---|---|---|---|---|---|
|
CustomClass
|
Определяемый пользователем класс CSS для применения к верхнему разделу виджета. Можно ввести несколько классов, разделенных пробелами.
|
STRING
|
Н/Д
|
Д
|
Н
|
||
|
RowFormat
|
Дополнительные правила для применения динамического (по состоянию) форматирования строк могут быть переопределены форматированием по состоянию ячейки.
|
STATE FORMATTING
|
Форматирование по состоянию
|
Н
|
Н
|
||
|
MultiSelect
|
Позволяет выбирать несколько элементов.
|
BOOLEAN
|
false
|
Н
|
Н
|
||
|
IsEditable
|
Разрешить править значения в сетке?
|
BOOLEAN
|
false
|
Н
|
Н
|
||
|
AutoSelectFirstRow
|
Автоматически выбирать первую строку при начальной загрузке данных.
|
BOOLEAN
|
false
|
Н
|
Н
|
||
|
CellTextWrapping
|
Переносить значения в ячейках.
|
BOOLEAN
|
false
|
Н
|
Н
|
||
|
Данные
|
Таблица данных, которая является источником данных для этого свойства.
|
INFOTABLE
|
Н/Д
|
Д
|
Н
|
||
|
CurrentScrollTop
|
Текущая прокрутка наверх.
|
NUMBER
|
0
|
Д
|
Н
|
||
|
ScrollTop
|
Прокрутка наверх для назначения.
|
NUMBER
|
0
|
Д
|
Н
|
||
|
EditedTable
|
Таблица, редактируется с помощью сетки.
|
INFOTABLE
|
Н/Д
|
Д
|
Н
|
||
|
RowHeight
|
Высота строк.
|
NUMBER
|
30
|
Н
|
Н
|
||
|
ShowAllColumns
|
Показать все доступные столбцы. Свойство ShowAllColumns необходимо использовать, если у таблицы данных нет структуры данных.
|
BOOLEAN
|
false
|
Н
|
Н
|
||
|
ShowDataLoading
|
Отображать данные при их загрузке.
|
BOOLEAN
|
True
|
Н
|
Н
|
||
|
DoubleClicked
|
Событие. Позволяет выбирать объект данных одним щелчком, а двойной щелчок использовать для другого события, такого как связывание двойного щелчка с запуском навигационной ссылки.
|
Н/Д
|
Н/Д
|
Д
|
Н
|
||
|
Видимый
|
Является ли виджет видимым во время выполнения?
|
BOOLEAN
|
True
|
Д
|
Н
|
Конфигурация сетки
После связывания сервиса данных с сеткой откройте диалоговое окно Grid Column Configuration. Можно выбрать, какие столбцы должны быть видимыми, с помощью флажков Hide (Скрыть) в столбце (true = показать, false = скрыть). Для изменения порядка отображаемых столбцов перетаскивайте их вверх и вниз в списке.
Название столбца автоматически назначается структурой данных сервиса данных, но может быть переопределен для столбца в диалоговом окне конфигурации. Для каждого столбца можно также:
• выбрать средство рендеринга для ячейки (используется для обработки определенного типа данных для отображения данных - рекомендуется);
• выбрать автоматическую или фиксированную ширину;
• выбрать выравнивание текста;
• выбрать стиль (фиксированный или форматирование по состоянию);
• обозначить столбец как редактируемый (с проверкой или без нее).
Если требуется применить фиксированный (нединамический) стиль, выберите Определение фиксированного стиля и выберите ранее заданное определение стиля. Если требуется применить динамическое форматирование (цветной контекст и т. д. на основе возвращаемых данных в строке), выберите "Форматирование на основе состояния".
При включении форматирования на основе состояния можно индивидуально настраивать каждый столбец данных, применяя определенный стиль к столбцу на основе данных в строке. Для каждого столбца, для которого требуется определить форматирование на основе состояния, необходимо выполнить следующее:
• Выберите столбец, от которого будет зависеть форматирование (это может быть любой столбец, скрытый или нет, в сервисе возврата данных).
• Выберите определение состояния, которое следует использовать (оно должно быть одним на столбец и соответствовать типу данных зависимого поля).
• Примите значения по умолчанию для определения состояния или переопределите их конкретно для определения и рендеринга этой сетки.
При задании сетки как редактируемой можно затем также обозначить определенные столбцы как редактируемые. Имеется также возможность добавить проверку, основанную на именах столбцов, с помощью сравнений JavaScript.
Пример:
Validation - Column1 > 5 && Column3 < 10
Message - You must have Col 1 > 5 and Col 3 < 10
Message - You must have Col 1 > 5 and Col 3 < 10