Таблица данных
Редактор таблицы данных (РТД) является компонентом, необходимым для изменения или просмотра одной Таблицы данных. Он используется:
Редактором свойств для редактирования переменных контекста
Журналом событий для просмотра Таблиц данных, относящихся к событиям
UI процедурой Редактировать данные для изменения параметров входа функции и просмотра ее выхода, и т.д.
А также многими другими средствами системы.
Большинство элементов Редактора таблицы данных, такие как заголовки столбцов и ячейки данных, обычно содержат всплывающие подсказки, которые появляются при наведении курсора мыши на элемент.
Всплывающая подсказка для заголовка столбца содержит поле type и строку help, заданные в формате таблицы, если такой определен.
Всплывающая подсказка для ячейки содержит строковое представление значения ячейки, а также тип поля, используемого для данной ячейки. Это может пригодиться, например, если:
значение ячейки слишком длинное и не помещается в ней,
редактор ячейки имеет допустимые значения, и вы хотите увидеть само значение, а не его описание в раскрывающемся списке.
Отображения временных меток
Редактор таблицы данных использует настройки Формат даты, Формат времени и Временная зона, заданные в Свойствах учетной записи пользователя, чтобы правильно преобразовывать и отображать временные метки.
Все значения даты/времени отображаются во временной зоне активного пользователя. Если временная зона не указана в настройках пользователя, будет использоваться временная зона SberMobile Server.
Источник данных
Редактор таблицы данных может использовать два типа источников данных:
Таблица данных
Это опция по умолчанию, которая чаще всего используется и отображает отдельную таблицу данных. В этом режиме прокрутка недоступна. Фильтрация и сортировка применимы к записям только в просматриваемой/редактируемой таблице.
Список экземпляров класса
В этом режиме редактируемая таблица представляет собой часть более длинного списка объектов (таких как экземпляры класса), доступного на стороне SberMobile Server.
Если список объектов используется в качестве источника, кнопки прокрутки и обновления доступны на панели инструментов. Если применяются правила фильтрации и сортировки, то фильтруются/сортируются серверные объекты, а не записи в отображаемой таблице.
Режимы
Редактор таблицы данных может работать с различных режимах, описанных в этом разделе.
Режимы редактирования
Доступны два режима редактирования:
Обычный режим. В этом режиме разрешено изменение значений.
Режим Только чтение. В этом режиме редактирование данных не разрешено.
Режимы представления данных
Существуют два режима представления данных:
Множество записей. В этом режиме заголовок таблицы показывает описание для множества столбцов, а каждый ряд представляет собой одну запись таблицы данных.
Отдельная запись (режим также называется Вертикальным). РТД использует этот режим, когда редактируемая таблица содержит всего одну запись, и добавление дополнительных записей невозможно. Этот режим имеет структуру из двух столбцов: левый столбец показывает имена полей, а правый содержит значения.
Панель инструментов
Панель инструментов Редактора таблицы данных обеспечивает доступ к операциям, которые могут выполняться с таблицей данных.
Показать/Скрыть дополнительные свойства | Эта триггерная кнопка используется, чтобы включить показ или скрытие полей или столбцов, помеченных как дополнительные. | |
![]() | Добавить ряд | Добавляет новый ряд перед выбранным на данный момент. Если ряд не выбран, новый добавляется в конец таблицы. Данная кнопка отключена или скрыта, если добавление рядов к таблице невозможно. Если компонент работает в режиме Список серверных объектов, эта кнопка позволяет вставить новый объект в список на стороне сервера, а не добавлять запись прямо с отображаемую таблицу. Сначала отобразится еще один Редактор таблица данных, чтобы дать заполнить поля вновь создаваемого объекта. Новый объект станет видимым, только если он отвечает текущим правилам фильтрации и подходит к текущей странице. В большинстве случаев, чтобы увидеть новый объект, потребуется нажать на кнопку "Обновить". |
Удалить выбранные ряды | Удаляет выбранный ряд (ряды). Данная кнопка отключена или скрыта, если удаление рядов из таблицы невозможно. Если компонент работает в режиме Список серверных объектов, эта кнопка удаляет объект(ы) из списка на стороне сервера помимо удаления соответствующих записей из отображаемой таблицы. | |
Предыдущая страница | Кнопка доступна только режиме Список серверных объектов. Делает прокрутку списка до предыдущей страницы. | |
Следующая страница | Кнопка доступна только режиме Список серверных объектов. Делает прокрутку списка до следующей страницы. | |
Переместить ряд | Положение отдельных строк можно изменить с помощью перетаскивания, нажав и удерживая значок "Переместить строку". Значок не отображается, если строки не могут быть переупорядочены. Упорядочивание строк таким образом изменяет фактические данные в таблице, в отличие от операций сортировки, которые просто изменяют способ отображения данных для пользователя. | |
Отменить изменения | Отменяет изменения в таблице. Данная кнопка включается только после того, как в таблицу были внесены изменения. | |
Выберите связанные объекты | Доступен для таблиц данных класса в экземплярных инструментальных панелях, которые отображают экземпляры класса, имеющие хотя бы одно отношение "Многие ко многим". Открывает окно, позволяющее создавать отношения "Многие ко многим". | |
Импорт таблицы данных | Импортирует данные из файла. | |
Экспорт таблицы данных | Экспортирует данные в файл. | |
Помощь | Открывает раздел документации, относящийся к редактируемым/просматриваемым данным. |
Обработка привязок данных
Редактор таблицы данных оперирует привязками, содержащимися в определении формата редактируемой Таблицы данных. Во время загрузки редактора, он читает список привязок для таблицы и обрабатывает их в фоновом режиме. Привязки оцениваются и используются для изменения ячеек таблицы. Выражения привязок, используемые редактором, могут содержать относительные ссылки на ячейки изменяемой таблицы вместе с ссылками на данные из различных контекстов. Чтобы узнать, как создать такие ссылки, прочтите информацию о привязках данных здесь.
Общие переменные (свойства)
[?]
Общие переменные: Имя, Видимый, Свойства расширения, Ширина сетки, Высота сетки, Выход за пределы контента, Стиль контейнера, Пользовательские классы, Стиль
Обще свойства
Компонент Таблица данных служит основой для некоторых других компонентов.
Переменные (свойства), общие для наследуемых компонентов, описаны в разделе Общие свойства.
Таблица данных
Имя переменной: | dataTable |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
dataTable | Data Table | Таблица данных, отображаемая в компоненте. |
Общие события
[?]
Общие события
Компонент Таблица данных служит основой для некоторых других компонентов.
События, общие для наследуемых компонентов, описаны в разделе Общие события.