В этом разделе описаны различные варианты использования Плавающих панелей, настройка этих вариантов в Application Model, дополнительная кастомизация с учетом платформы целевого приложения.

Содержание:

Варианты использования

Плавающая панель может сопровождать конкретное View, бизнес-класс или главное окно.

Чтобы добавить новую Плавающую панель для бизнес класса, вызовите Model Editor, перейдите в соответствующий узел BOModel|Class|DockPanels, вызовите контекстное меню и выполните Add|ClassDockPanel.

Плавающие панели для View и главного окна добавляются аналогично в узлах Views|...|DockPanels и Xafari|DockPanels:

В узле новой Плавающей панели обязательно нужно установить два значения: View и Guid.

Указанное View будет отображаться внутри Плавающей панели.

Guid это уникальный идентификатор, важно, чтобы все Плавающие панели в приложении имели различные идентификаторы.

Плавающие панели для бизнес-класса и для View могут отображать данные с учетом отношений Master-Detail между объектами основного View (General View) и объектами на панели. Для этого нужно корректно задать значения RelationType и RelationCriteria.

RelationType может принимать одно из следующих значений: Independent, Master, Details, DetailsCurrentObject.

RelationCriteria

Дополнительная кастомизация

Настройки Плавающих панелей в Application Model делятся на следующие группы:

Платформенно-независимые настройки

Платформенно-независимые настройки являются общими. Они предоставляются модулем XafariDockPanelsModule. Узел любой Плавающей панели независимо от платформы целевого приложения предоставляет следующие настройки:

ActionsToolbarVisibility определяет, будет ли Плавающая панель отображать панель инструментов (Toolbar).

AllowEdit определяет возможность редактировать отображаемые данные.

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

Group задает дополнительный уровень группировки при отображении Action, управляющего видимостью Плавающей панели:

RelationType указывает тип отношений между объектами, отображаемыми на Плавающей панели, и объектами, отображаемыми на основном View. Описано выше в разделе «Варианты использования».

TargetViewType определяет тип основного View, для которого Плавающая панель будет активна. Эта настройка доступна только для ClassDockPanel (см. «Варианты использования»).

TargetWindowType определяет тип окон, для которых Плавающая панель будет доступна.

Criteria позволяет задать дополнительный фильтр для List View, эта настройка доступна только в том случае, если Плавающая панель отображает List View.

RelationCriteria определяет criteria operator, применяемый к отображаемому View.

View определяет View приложения для отображения внутри Плавающей панели.

Guid это уникальный идентификатор, важно, чтобы все Плавающие панели в приложении имели различные идентификаторы.

Настройки, специфичные для Win-приложений

При использовании в Windows Forms приложениях, настройки Плавающих панелей расширяются 2-мя позициями:

DockStyle определяет первоначальное размещение панели.

DockVisibility определяет первоначальную видимость панели.

Настройки, специфичные для Web-платформы

При использовании в ASP.NET приложениях, настройки Плавающих панелей расширяются 11-ю позициями:

MinHeight определяет минимально допустимую высоту окна Плавающей панели.

MinWidth определяет минимально допустимую ширину окна Плавающей панели.

ShowCloseButton определяет, отображать или нет кнопку Close на окне Плавающей панели.

ShowCollapseButton определяет, отображать или нет кнопку Collapse на окне Плавающей панели.

ShowMaximizeButton определяет, отображать или нет кнопку Maximize на окне Плавающей панели.

ShowPinButton определяет, отображать или нет кнопку Pin на окне Плавающей панели.

ShowRefreshButton определяет, отображать или нет кнопку Refresh на окне Плавающей панели.

ShowFooter определяет, отображать или нет нижний колонтитул на окне Плавающей панели.

ShowHeader определяет, отображать или нет верхний колонтитул на окне Плавающей панели.

AllowResize определяет, можно или нет конечному пользователю изменять размер окна Плавающей панели.

Visible определяет начальную видимость Плавающей панели.