3.5.2.2.10. 滚动盒子布局

在线示例

API 文档

ScrollBoxLayout − 一个支持内容滚动的容器。

该组件的 XML 名称： scrollBox

下面是一个 XML 描述示例：

<groupBox caption="Order" width="300" height="170">
    <scrollBox width="100%" height="100%" spacing="true" margin="true">
        <dateField dataContainer="orderDc" property="date" caption="Date"/>
        <lookupField dataContainer="orderDc" property="customer" optionsContainer="customersDc" caption="Customer"/>
        <textField dataContainer="orderDc" property="amount" caption="Amount"/>
    </scrollBox>
</groupBox>

• 组件排列的方向可以通过 orientation 属性定义 ，可选值： horizontal 或 vertical。默认为 vertical。

• scrollBars 属性可以配置滚动条。它的值可以是 horizontal 或者 vertical - 分别用于水平滚动和垂直滚动，both - 两个方向都有滚动条。将值设置为 none 禁止向任何方向的滚动。

• contentHeight - 设置内容高度。

• contentWidth - 设置内容宽度。

• contentMaxHeight - 设置内容的最大 CSS 高度，例如，"640px"、"100%"。

• contentMinHeight - 设置内容的最小 CSS 高度，例如，"640px"、"auto"。

• contentMaxWidth - 设置内容的最大 CSS 宽度，例如，"640px"、"100%"。

• contentMinWidth - 设置内容的最小 CSS 宽度，例如，"640px"、"auto"。

<layout>
    <scrollBox contentMinWidth="600px"
               contentMinHeight="200px"
               height="100%"
               width="100%">
        <textArea height="150px"
                  width="800px"/>
    </scrollBox>
</layout>

Figure 23. 带有 textArea 的显示完整的 scrollBox

Figure 24. 窗口尺寸调整时滚动条出现，管理内容的宽度

可以在 ScrollBox 中使用快捷键。使用 addShortcutAction() 方法设置快捷键和要执行的操作：

scrollBox.addShortcutAction(new ShortcutAction("SHIFT-A", shortcutTriggeredEvent ->
        notifications.create()
                .withCaption("SHIFT-A action")
                .show()
));

scrollBox 的属性

align - caption - captionAsHtml - contextHelpText - contextHelpTextHtmlEnabled - css - description - descriptionAsHtml - box.expandRatio - height - id - margin - orientation - scrollBars - spacing - stylename - width

API

add - addShortcutAction - getComponent - getComponentNN - getComponents - getMargin - getOwnComponent - getOwnComponents - indexOf - remove - removeAll - setMargin - setSpacing