Элемент управления DocumentGridViewPanel (из пространства имен Ultima.Client.Controls) используется для отображения содержимого журналов документов. Он состоит из:

•панели инструментов (1);

•таблицы, содержащей документы (2) – элемента управления GridControl пакета DevExpress:

Элемент управления обладает следующими специфичными свойствами:

•DocumentType – тип документа, с которым работает элемент управления;

•AutoBestFitAfterColumnSelection – в значении true после выбора отображаемых в таблице (GridControl) колонок, для них будет автоматически подобрана оптимальная ширина;

•CanDragToolbar – в значении true позволяет изменять положение панели инструментов (1);

•CheckColumnVisible – в значении true отображается колонка выбора документов:

•CommandsMenuVisible – в значении true отображается кнопка списка команд над документами (6). Кнопка видна только если существуют команды над документами этого типа;

•DeleteButtonEnabled – в значении true кнопка удаления документа (4), если она отображается в панели инструментов, доступна для нажатия. Свойство выставляется автоматически в зависимости от прав пользователя, открывающего журнал документов;

•DeleteButtonVisible – в значении true отображается кнопка удаления документа(4);

•EditButtonEnabled – в значении true кнопка редактирования документа (5), если она отображается в панели инструментов, доступна для нажатия. Свойство выставляется автоматически в зависимости от прав пользователя, открывающего журнал документов;

•EditButtonVisible – в значении true отображается кнопка редактирования документа (5);

•FilterButtonVisible – в значении true отображается кнопка открытия/сокрытия панели фильтра (13);

•FilterPanelVisible – в значении true отображается панель фильтра (13);

•FilterPanelWidth – ширина в пикселях панели фильтра (13) по умолчанию;

•FitColumnButtonVisible – в значении true отображается кнопка автоматического подбора оптимальной ширины колонок таблицы (GridControl) (10);

•GroupButtonVisible – в значении true отображается кнопка открытия/сокрытия панели группировки (9);

•GroupPanelVisible – в значении true под панелью инструментов (1) отображается панель группировки:

•LimitCounterValue – значение по умолчанию счетчика (11), ограничивающего число выводимых в форме документов;

•LimitCounterVisible – в значении true отображается счетчик (11), ограничивающий число выводимых в форме документов;

•LimitCounterWidth – ширина в пикселях поля ввода значения счетчика (11);

•NewButtonEnabled – в значении true кнопка создания нового документа (3), если она отображается в панели инструментов, доступна для нажатия. Свойство выставляется автоматически в зависимости от прав пользователя, открывающего журнал документов;

•NewButtonVisible – в значении true отображается кнопка создания нового документа (3);

•PrintButtonVisible – в значении true отображается кнопка печати (7);

•QuickCommandsVisible – в значении true в нижней части элемента управления отображается панель с командами над документами, добавленными в быстрый доступ. Панель видна только в том случае, если в нее были добавлены команды;

•ReloadButtonVisible – в значении true отображается кнопка перезагрузки документов (12);

•SaveSelectedColumns – в значении true подбор колонок, осуществленный пользователем с помощью соответствующего инструмента (8), будет запомнен;

•SelectColumnsButtonEnabled – в значении true кнопка подбора колонок (8), если она отображается в панели инструментов, доступна для нажатия;

•SelectColumnsButtonVisible – в значении true отображается кнопка подбора выводимых в таблице колонок – свойств документа (8);

•ToolbarVisible – в значении true отображается панель инструментов (1).

При использовании элемента управления помимо указания типа документа DictionaryType в его свойствах, необходимо привязать тот же тип документа к входящему в его состав элементу управления GridControl.

Класс элемента управления DocumentGridViewPanel реализует следующие методы и обладает следующими свойствами:

•DocumentType, типа type – возвращает тип документа;

•CheckedRecordsCount, типа int – возвращает число выбранных в элементе управления документов;

•CheckedRecords, типа long[] – возвращает массив идентификаторов выбранных в элементе управления документов;

•LoadRecords() – загружает записи справочника в элемент управления GridControl;

•ApplyCustomFilter – событие, которое выполняется после загрузки записей (LoadRecords). Поддерживает строго типизированные фильтры и может выполняться асинхронно.