This comboBox tag is used to show an edit box.

Relationship with other tags

The comboBox tag is child tag of formLayout or panelLayout.

The comboBox tag does not have any child tag.


The following example shows the XML for a comboBox tag.

   <formLayout columns="1";   blockSize="5" fieldWidth="400" >
      <comboBox label="#{workitemmodel.labels.TASKID}" value="#{workitemmodel.values.TASKID}" readOnly="true" 
                   valueSet="#{workitemmodel.listItems.STATUS}" readOnly="true" id="statusID" >
   </formLayout > 


Name Type Supports EL? Description
disabled String no If set to true, the control is in ready only mode.
id String no UI component identifier. There could be multiple comboBox controls and this id attribute is used to uniquely identify the control.
label String yes Localized string shown as the field (or control) label.
maximumLength String no Maximum length of the control in pixels.
pprTargets String no UI component ID that needs to be refreshed after the value of this comboBox field is updated. It can be a single ID or a group of IDs seperated by comma. This is used when configuring dependent fields.
readOnly String no If set to true, no user input is allowed. The control is disabled.
required String yes If set to true, user has to provide approporiate value. It can also take an EL expersion like "#{workitemmodel.required.OWNER}", which will use value from the "required" attribute of the corresponding field defined in the model XML.
value String yes Field value to shown. It muts be one of the values inside the combo box.
valueSet String yes Defines where to get the list of values. Normally it takes a format as "#{workitemmodel.listItems.GENERIC_OR_PORT_SPECIFIC}" where listItems specifies that the data to be fetech is for a combo box.