4.5.2.3.2. Presentation

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

Возможности:

  • Сохранение представлений под уникальными именами

  • Редактирование и удаление представлений

  • Быстрое переключение между представлениями

  • Задание представления по умолчанию, которое будет применяться при открытии экрана с компонентом

  • Автосохранение настроек отображения в активном представлении

  • Глобальные представления, которые доступны всем пользователям системы

Классы и интерфейсы

Для применения представлений класс компонента должен реализовывать интерфейс com.haulmont.cuba.gui.components.Component.HasPresentations. В платформе такими компонентами являются:

Presentation − POJO объект представления.

Presentations содержит список представлений компонента и набор методов по работе с ними. Основные методы:

  • getCurrent() − возвращает текущее активное представление или null, если представление не выбрано

  • setCurrent(Presentation p) − устанавливает активное представление

  • getSettings(Presentation p) − возвращает XML-элемент настроек отображения для указанного представления

  • setSettings(Presentation p, Element e) − модифицирует настройки отображения для указанного представления

  • getPresentation(Object id) − возвращает представление по его идентификатору

  • getPresentations() − возвращает список идентификаторов представлений для данного компонента

  • commit() − сохраняет представления в базу данных

PresentationsImpl − реализация интерфейса Presentations.

PresentationsChangeListener − интерфейс слушателя изменений представлений.

Для создания, изменения, удаления глобальных представлений пользователь должен иметь права cuba.gui.presentations.global. Подробнее см. руководство Платформа CUBA. Подсистема безопасности.