JSF 1.1 复选框组件

另请参见

您可以将复选框组件 “复选框”组件图标 从组件面板的“基本”类别拖到可视设计器中,以便创建带有可选标签的单个复选框。

如果需要在组中以标签预设格式的一组复选框,则可以改用复选框组组件

可以将复选框放到容器组件上,如表单元格或组框上。

复选框可以表示任何对象,无论该对象属于预定义的类(如 BooleanByteCharacterDoubleFloatIntegerLongShortString),还是属于您定义的类。复选框还可以表示基元值。

 

单个复选框可用于表示几种类型的数据:

一组复选框可用于表示以下内容:

复选框组件在以下情况下可能很有用:复选框组组件的布局不太理想,如用于选择或取消选择表行的复选框。

右键单击该组件可以选择以下某项:

检测选中的复选框

复选框组件使用 selectedselectedValue 属性来传递有关复选框选择状态的信息。selected 属性用于表示已选中复选框并在页面中显示复选标记。selectedValue 属性用于传递复选框的数据值。如果 selected 属性值与 selectedValue 属性值相等,则认为已选中复选框。通过给 selectedValueselected 属性赋相同的值,可以在最初查看页面时将复选框显示为选中状态。

如果未指定 selectedValue 属性或其值为 null,则复选框的行为类似于布尔型控件。在这种情况下,如果选中了复选框,则 selected 属性值是一个结果为 true 的 Boolean 实例。如果未选中复选框,则 selected 属性值是一个结果为 false 的 Boolean 实例。

可以将计算结果为基元值的值绑定表达式赋给 selectedselectedValue 属性。

将复选框组件用作布尔型控件

如果未指定 selectedValue 属性或其值为 null,则复选框的行为类似于布尔型控件。

要将复选框用作布尔型控件,请不要指定 selectedValue 属性的值。如果 selected 属性不为 null,并且具有结果为 true 的 Boolean 实例值或布尔型基元值,则该复选框处于选中状态。如果未选中该复选框,则 selected 属性值是一个结果为 false 的 Boolean 实例或布尔型基元。

使用复选框表示应用程序定义的值

可以将 selectedValue 属性赋给应用程序定义的对象值,以表示所选中的复选框的值。如果选中复选框,则会将 selected 属性值赋给 selectedValue 属性值。

如果 selectedValue 属性值是应用程序定义的对象,则必须注册转换器以转换为 String 值或从中进行转换。转换器用于将复选框值编码为 HTML <input> 元素的值,以便对请求中的提交值进行解码。此外,该对象还必须支持 equals() 方法;在将 selectedValue 属性值与 selected 属性值进行比较以检测选中的复选框时,该方法将返回 true

另请参见
复选框组件属性窗口
绑定组件属性
使用组件
组件任务:快速参考
关于 Visual Web 组件面板

法律声明