多选组件允许用户从一列值中选择一项或多项。用户的选择将存储在 PageHandler 数组数据区中。复选框组和多选列表框都是多选
JavaServer Faces 组件。
绑定是组件与数据区之间的一种关系。必须先在 PageHandler 中声明数据区,才能将其与组件绑定。多选组件需要两种不同类型的绑定:
- 与一个或多个数据区的绑定,这些数据区包含用户可从中进行选择的值
- 与将接收用户选择的数组数据区的绑定
要将 JavaServer Faces 多选组件与现有 EGL PageHandler 数据区绑定,执行下列操作:
- 在 Page Designer 中打开 Faces JSP 文件。如果尚未打开该 JSP 文件,则在“项目资源管理器”中双击该 JSP 文件。该 JSP 文件便在 Page Designer 中打开了。单击设计选项卡以访问“设计”视图。
- 从窗口菜单中,选择显示视图 > 其它
> 基本 > 选用板。
- 在“选用板”视图中,单击 Faces 组件抽屉以显示 Faces 组件对象类型。
- 将多选组件从选用板拖至 JSP。组件对象将放在 JSP 上。
- 要将组件与一个或多个 PageHandler 数据区绑定,而这些数据区包含要显示给用户的值,则执行下列其中一个过程:
- 可将组件与各个 PageHandler 数据区绑定,每个数据区包含一个列表项。对每个数据区执行以下过程:
- 在 JSP 上选择该对象组件。
- 在“属性”视图中,单击添加选项。“名称”和“值”字段中填充了缺省值。
- 单击名称字段,然后输入要显示给用户的文本。
- 单击值字段,然后单击值字段旁边的按钮。从“选择页数据对象”列表中选择单个数据区并单击确定。
此数据区包含将移至接收数据区的值。
- 可将组件与 PageHandler 数组数据区绑定,该数据区包含要显示给用户的值。执行以下过程以将该组件与数组数据区绑定:
- 在 JSP 上选择该对象组件。
- 在“属性”视图中,单击添加选项组。“名称”和“值”字段中填充了缺省值。
- 单击值字段,然后单击值字段旁边的按钮。从“选择页数据对象”列表中选择数组数据区并单击确定。
数组数据区中的值就是要显示给用户的值。稍后描述的属性将确定移至接收数据区的是数组数据区中的值还是功能相当的索引值。
- 如果要使用数组数据区来提供向用户显示的值,必须使用以下两个属性来定义接收数据区:selectFromListItem
和 selectType。selectFromListItem 属性指向包含列表项的数组。selectType
属性指示是以文本值还是以索引值来填充接收数据区。以下是接收数据区的一些示例:
colorSelected char(10)
{selectFromListItem = "colorsArray",
selectType = value};
colorSelectIdx smallInt
{selectFromListItem = "colorsArray",
selectType = index};
- 要将该组件与将接收用户选择的 PageHandler 数组数据区绑定,执行下列操作:
- 在 JSP 上选择该组件对象
- 单击“属性”视图的值字段旁边的按钮
- 从“选择页数据对象”列表中选择数据区
- 单击确定