gui_GroupBoxLayout.adoc

GroupBoxLayout

ДЕМОНСТРАЦИЯ

API DOCS

GroupBoxLayout - контейнер, позволяющий выделить рамкой содержащиеся в нем компоненты, и задать им общий заголовок. Кроме того, он умеет сворачивать свое содержимое.

XML-имя компонента: groupBox.

Пример описание контейнера в XML-дескрипторе экрана:

link:../../../../../../source/gui_vcl/groupboxlayout_1.xml[role=include]

Атрибуты groupBox:

• caption - заголовок группы.

• orientation - задает направление расположения вложенных компонентов − horizontal или vertical. По умолчанию vertical.

• collapsable − значение true позволяет пользователю скрывать содержимое компонента с помощью значков /.

• collapsed − если указано значение true, то содержимое компонента будет свернуто сразу после открытия экрана. Используется совместно с collapsable="true".

  Пример свернутого GroupBox:

  

  Изменения состояния компонента groupBox (сворачивание и разворачивание) можно отслеживать с помощью интерфейса ExpandedStateChangeListener.

• outerMargin - устанавливает внешние поля вокруг границы groupBox. Если указано значение true, внешние поля будут добавлены ко всем сторонам компонента. Чтобы задать внешние поля индивидуально, укажите значения true или false для каждой стороны groupBox:

  <groupBox outerMargin="true, false, true, false">

  Если атрибут showAsPanel установлен в true, outerMargin игнорируется.

• showAsPanel – если указано значение true, то компонент будет выглядеть как Vaadin Panel. Значение по-умолчанию - false.

  

Контейнер groupBox по умолчанию имеет ширину 100% аналогично vbox.

В веб-клиенте к компоненту groupBox можно применить предопределенные стили. Стили задаются в XML-дексрипторе или контроллере экрана с помощью атрибута stylename. Чтобы применить стиль программно, выберите одну из констант класса HaloTheme с префиксом компонента LAYOUT_ или GROUPBOX_. Следующие стили должны использоваться совместно с атрибутом showAsPanel, имеющим значение true:

• стиль borderless удаляет рамку и фон контейнера groupBox:

  link:../../../../../../source/gui_vcl/groupboxlayout_3.java[role=include]

• стиль card придаёт контейнеру вид карточки.

• стиль well делает контейнер "утопленным" с затемнением фона:

  link:../../../../../../source/gui_vcl/groupboxlayout_2.xml[role=include]

  

Существует дополнительный предопределенный стиль контейнера groupBox - light. Этот стиль можно задать с помощью атрибута stylename. Groupbox со стилем light имеет только верхнюю границу, как показано в примере ниже.

В компоненте Groupbox можно использовать горячие клавиши. Задать сочетание клавиш и вызываемое действие можно с помощью метода addShortcutAction():

link:../../../../../../source/gui_vcl/groupboxlayout.java[role=include]

---

Атрибуты groupBox

align - caption - captionAsHtml - collapsable - collapsed - contextHelpText - contextHelpTextHtmlEnabled - css - description - descriptionAsHtml - expand - box.expandRatio - height - id - orientation - outerMargin - settingsEnabled - spacing - stylename - width

Предопределенные стили groupBox

borderless - card - light - well

API

add - addExpandedStateChangeListener - addShortcutAction - applySettings - getComponent - getComponentNN - getComponents - getOwnComponent - getOwnComponents - indexOf - remove - removeAll - saveSettings - setOuterMargin - setSpacing

---