You see the Properties window for a Checkbox component
when you select the checkbox on a page that you are editing in the Visual Designer. Most of the component's properties are both JSP attributes and properties of the Checkbox Java component in the page bean.
This component has the following properties.
Type: String Type: StringIf you navigate to a file, select the file and click OK. You see the image displayed next to the checkbox. The image file is copied to the project, and you can see it in the Projects window under project-name > Web Pages > resources.
Type: Stringlabel property is not as flexible as the Label component. You can use the Label component if you want more control over the label's appearance, such as positioning of the label relative to the component. Type: int Type: String position: absolute; left: 288px; top: 312px
You can enter values directly or click the ellipsis (...) button to use the Style Editor.
For a list of CSS2 style attributes, see the web page at
Type: Stringstyle property description for an explanation of why a class added to this property might appear to have no effect on the component. The defaulttheme CSS style classes for this component are:
css_master.css
.CbDis, .RbDis {background-color:#E1E4E5;color:#848687}
.Cb {}
.Rb {}
.RbSpn input {vertical-align: 1px}
.CbSpn input {vertical-align: -1px}
.CbGrp td, .RbGrp td {text-align: left}
.CbGrp label, .RbGrp label {vertical-align: 6px}
css_ie55up.css
/* ADDITIONAL CSS FOR IE5.5+ SUPPORT */
.RbSpn input, .CbSpn input {vertical-align: 3px;}
Type: ConverterselectedValue property. If the value of the selectedValue property is an application-defined object, a converter must be registered to convert to and from a String value. The converter is used to encode the checkbox value as the value of the HTML <input> element and to decode the submitted value in a request. In addition the object must support an equals() method that returns true when the value of the selectedValue property is compared to the selected property value in order to detect a selected checkbox. Type: Object selectedValue property is not set, the value is true if the checkbox is selected or false if the checkbox is not selected. If the selectedValue property is set, then the selected property has the same value as the selectedValue property when the user selects the checkbox.
Checkbox Java component has an isChecked() method that returns true if the component is selected.
Type: MethodBinding(null), no validator is called.
Set the event properties by right-clicking the component in the Visual Designer and choosing Edit Event Handler > eventname.
validator property, right-click the component and choose Edit Event Handler > validate. The default name for the method is component-id_validate, where component-id is the value of the component's id property. When you define this method in this way, the validator and validate properties are automatically set for you. If you define a validator, also select the required property to ensure that the validator is used.
validator property. If you define your own validate method, do not separately change the value of the validator property, or you could lose the connection to your validate method.component-id_processValueChange, where component-id is the value of the component's id property. Type: booleanreadOnly property concerning the effects of using the disabled property versus the effects of using the readOnly property. Type: booleandisabled property, JavaServer Faces does not detect that any value at all was submitted. Type: Stringtitle attribute of the component, which is readable by a screen reader and can be displayed as a tool tip.
Type: booleanrendered property. Type: Stringtabindex attribute of the HTML <input> tag. Type: String Type: String Type: String Type: String Type: String Type: String Type: String Type: String Type: String Type: String Type: String Type: String Type: String Type: booleanThe most common example of an immediate action is a Cancel button. You make it immediate so that the normal validation and update steps can be skipped, but the action handler can still do whatever is necessary. Typically, the action handler will navigate back to some previous page. In some designs the action handler might also enqueue an informational message like "Transaction cancelled". It is possible to do more: for example, an application might record the fact that the user cancelled the current operation.
Type: boolean Type: Object selectedValue attribute is not specified or its value is null, the checkbox behaves like a boolean control. In this case, if the user selects the Checkbox component, the value of the selected attribute is a true Boolean instance. If the Checkbox is not selected, the value of the selected attribute is a false Boolean instance.
The selectedValue property can be assigned an application-defined object value to represent the value of a selected checkbox. If the checkbox is selected, the value of the selected property is assigned the value of the selectedValue property. A value binding expression that evaluates to a primitive value can be assigned to this property.
If the value of the selectedValue property is an application-defined object, a converter must be registered with the converter property to convert to and from a String value.
Type: MethodBindingvalueChange property above, which provides an easier way to set this property's value. The valueChangeListener property is the MethodBinding that underlies the valueChange event property. The valueChangeListener property is updated when you set the method for the valueChange event property.
If you click the ellipsis button next to the valueChange property, you can use that property's property editor to choose an existing method to bind to, or you can create a new method or unbind an existing method. If you are an expert, instead of using the valueChange property, you can type a MethodBinding expression directly into this valueChangeListener property, for example, if you want to call a method that is not in the page bean.