You see the Properties window for a Listbox component
when you select the component on a page that you are editing in the Visual Designer.
This component has the following properties.
Type: Stringid attribute. In the page bean, this property's value is the name of the HtmlSelectOneListbox object. 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 label property is set. Type: boolean Type: boolean Type: int Type: boolean com.sun.rave.web.ui.model.OptionGroup class. This property is selected by default. 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
/* Regular List */
.Lst {border-bottom-color:#666;border-right-color:#666}
.Lst, .LstOpt, .LstOptSel, .LstOptGrp {color:#000}
.LstOptSep, .LstOptDis {color:#848687}
.LstOptGrp {font-weight:normal;font-style:normal}
/* Contextual Selector for Disabled Appearance */
.LstDis {border-bottom-color:#666;border-right-color:#666}
.LstDis, .LstDis option, .LstDis .LstOptGrp
{background-color:#E1E4E5;color:#848687}
.LstDis .LstOptGrp {font-weight:normal;font-style:normal}
/* Monospace Version */
.LstMno {border-bottom-color:#666;border-right-color:#666}
.LstMno, .LstMno .LstOptGrp {color:#000}
.LstMno, .LstMno option, .LstMno .LstOptGrp {font-family:monospace}
.LstMno .LstOptGrp {font-weight:normal;font-style:normal}
/* Contextual Selector for Disabled Monospace Version */
.LstMnoDis, .LstMnoDis option, .LstMnoDis .LstOptGrp
{background-color:#E1E4E5;color:#848687;
font-family:monospace}
.LstMnoDis .LstOptGrp {font-weight:normal;font-style:normal}
.LstAln {vertical-align:top;padding-right:5px}
Type: Converterselected property. Type: Objectcom.sun.rave.web.ui.model.Option. Type: boolean Type: booleanfor property to this component, an error message will be displayed if the user tries to submit the page without selecting an item.
Type: Objectitems property, described above. You can bind this property to a data provider or an object by clicking the ellipsis button (...) and using the property editor. Type: MethodBinding(null), no validator is called. If you choose a validator, also select the required property to ensure that the validator is used.
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.null. You typically define this method in the page bean by right-clicking the component in the Visual Designer and choosing Edit Event Handler > processValueChange. The default name for the method is 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: String Type: booleanrendered property. 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: String Type: booleanThe most common example of an immediate action is a Cancel button. You can 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: booleanvisible property instead of this property.
You can bind this property to a JavaBeans property that determines when the component does get rendered. For example, an airline reservation form might show a component for frequent flyers and not show it for the general public. To bind this property, click the ellipsis button (...) to the right of the property and choose Use Binding in the dialog box.
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.