您可以将复选框组件
从组件面板的“Woodstock 基本”类别拖到可视设计器中,以便创建带有可选标签的单个复选框。
如果需要在组中以标签预设格式的一组复选框,则可以改用复选框组组件。
可以将复选框放到容器组件上,如表单元格或组框上。
复选框可以表示任何对象,无论该对象属于预定义的类(如 Boolean、Byte、Character、Double、Float、Integer、Long、Short、String),还是属于您定义的类。复选框还可以表示基元值。
单个复选框可用于表示几种类型的数据:
一组复选框可用于表示以下内容:
复选框组件在以下情况下可能很有用:复选框组组件的布局不太理想,如用于选择或取消选择表行的复选框。
右键单击该组件可以选择以下某项:
validate 方法上,以便插入代码来验证组件的值。processValueChange 方法上,以便插入在该组件的值发生更改时(例如,用户更改了另一个组件的值,而这个组件正在控制该组件的值)执行的代码。common_timeoutSubmitForm(this.form, 'component-id');。在运行时,如果用户更改了组件值,该代码将导致自动提交表单。在提交表单后,将在服务器上进行转换和验证,执行任何值更改侦听程序方法,然后重新显示页面。
配置为“更改时自动提交”的组件可以使用虚拟表单来限制在提交表单时处理的输入字段。如果定义了自动提交组件来提交虚拟表单,则在进行自动提交时,将只处理该虚拟表单中的参与者。
selected 属性绑定到数据提供器或对象,以使应用程序可以在提交页面时计算该属性。有关详细信息,请参见“绑定到数据”对话框。selected 属性之外的组件属性绑定到其他对象或 Bean 属性,这些对象或属性将自动更新此组件的属性。 复选框组件使用 selected 和 selectedValue 属性来传递有关复选框选择状态的信息。selected 属性用于表示已选中复选框并在页面中显示复选标记。selectedValue 属性用于传递复选框的数据值。如果 selected 属性值与 selectedValue 属性值相等,则认为已选中复选框。通过给 selectedValue 和 selected 属性赋相同的值,可以在最初查看页面时将复选框显示为选中状态。
如果未指定 selectedValue 属性或其值为 null,则复选框的行为类似于布尔型控件。在这种情况下,如果选中了复选框,则 selected 属性值是一个结果为 true 的 Boolean 实例。如果未选中复选框,则 selected 属性值是一个结果为 false 的 Boolean 实例。
可以将计算结果为基元值的值绑定表达式赋给 selected 和 selectedValue 属性。
如果未指定 selectedValue 属性或其值为 null,则复选框的行为类似于布尔型控件。
要将复选框用作布尔型控件,请不要指定 selectedValue 属性的值。如果 selected 属性不为 null,并且具有结果为 true 的 Boolean 实例值或布尔型基元值,则该复选框处于选中状态。如果未选中该复选框,则 selected 属性值是一个结果为 false 的 Boolean 实例或布尔型基元。
true 值的 ArrayList。 可以将 selectedValue 属性赋给应用程序定义的对象值,以表示所选中的复选框的值。如果选中复选框,则会将 selected 属性值赋给 selectedValue 属性值。
如果 selectedValue 属性值是应用程序定义的对象,则必须注册转换器以转换为 String 值或从中进行转换。转换器用于将复选框值编码为 HTML <input> 元素的值,以便对请求中的提交值进行解码。此外,为了检测选中的复选框,该对象还必须支持 equals 方法,当 selectedValue 属性值与 selected 属性值相等时,该方法将返回 true。