Поделиться через


Сетки и подопределения в приложениях на основе моделей (справочник по клиентскому API)

Сетки представляют данные в табличном формате в приложениях на основе модели. Сетки могут охватывать всю форму или быть одним из элементов в форме; последнее называется подгридами.

Типы сетки

В приложениях на основе модели существует два типа сетки:

  • Сетки только для чтения: отображение данных в табличном формате. Чтобы изменить данные, отображаемые в сетке только для чтения, необходимо выбрать запись в сетке, чтобы открыть форму, изменить данные, а затем сохранить.
  • Редактируемые сетки. Помимо отображения данных в табличном формате, предоставляет широкие возможности встроенного редактирования в веб-клиентах и мобильных клиентах, включая возможность группировать, сортировать и фильтровать данные в одной сетке, чтобы не переключение записей или представлений. Редактируемая сетка — это пользовательский элемент управления, который поддерживается в основной сетке и подопределениях формы в веб-клиенте и на панелях мониторинга и в сетках форм на мобильных клиентах. Хотя редактируемый элемент управления сеткой предоставляет возможность редактирования, он учитывает метаданные сетки только для чтения и параметры безопасности на уровне поля.

Получение контекста сетки

Контекст сетки — это экземпляр сетки или подопределения в форме, для которой требуется запустить код. Дополнительные сведения о получении контекста сетки для выполнения кода JavaScript см. в контексте сетки клиентского API

Events

Имя Description Применимо для
Событие OnLoad subgrid Происходит каждый раз при обновлении подопределения. Это включает в себя, когда пользователи сортируют значения в подопределении, щелкнув заголовки столбцов. Сетка только для чтения
Grid OnChange Происходит при изменении значения в ячейке в редактируемой сетке, а ячейка теряет фокус. Редактируемая сетка
Grid OnRecordSelect Происходит при выборе одной строки (записи) в редактируемой сетке Редактируемая сетка
Сетка onsave Происходит перед отправкой обновленной информации на сервер и при возникновении любого из следующих ситуаций: происходит изменение выбора записи, пользователь явно активирует операцию сохранения с помощью кнопки сохранения редактируемой сетки, или пользователь применяет сортировку, фильтр, группу, страницы или операцию навигации из редактируемой сетки во время ожидающих изменений. Редактируемая сетка

Замечание

Вы можете зарегистрировать события OnChange, OnRecordSelect и OnSave с помощью вкладки "События " страницы приложений на основе модели, которая используется для включения редактируемых сетки для таблицы или сетки только для чтения.

Объекты

Используйте следующие объекты для взаимодействия с сетками. Эти объекты образуют иерархию, как показано на следующей схеме:

Иерархия объектов, доступных в сетках

Имя Description Доступно для
GridControl Предоставляет методы для работы с элементом управления grid или subgrid. Сетки только для чтения и редактирования
Сетка Предоставляет методы для доступа к данным в сетке. Сетки только для чтения и редактирования
GridRow Предоставляет методы для работы с строками или выбранными строками в сетке. Сетки только для чтения и редактирования
GridRowData Предоставляет методы для работы с строками или выбранными строками в сетке. Сетки только для чтения и редактирования
GridEntity Предоставляет методы для доступа к данным о конкретных записях в строках. Сетки только для чтения и редактирования
GridAttribute Предоставляет методы для доступа к данным в ячейке редактируемой сетки. Редактируемая сетка
GridCell Предоставляет методы для доступа к данным, связанным с элементом управления в форме, привязанной к столбцу в редактируемой сетке. Редактируемая сетка
ViewSelector Предоставляет методы для получения или задания сведений о селекторе представлений элемента управления subgrid. Сетка только для чтения

Контекст сетки API клиента
Использование редактируемых сетки
Справочник по КЛИЕНТСКОму API для приложений на основе моделей
Обзор разработчиков приложений на основе моделей