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