Skip to main content

List Box Properties

This section describes the properties available for a list box element in the page definition.

Effective Constraint

PropertyDescriptionExample
Constraint SourceThe location that is providing the constraint for this element.TEMPLATE_constraint.
Constraint TypeThe type of constraint for this element, i.e.
Bounds - The element is being position absolutely.
Flow - The element is flowing.
None - The element has no position constraint.
BOUNDS
heightThe height of the element in pixels.63
widthThe width of the element in pixels.281
xThe x location of the element in pixels, relative to its parent element.445
yThe y location of the element in pixels, relative to its parent element.184

Element Constraint

PropertyDescriptionExample
Constraint TypeThe type of constraint to apply to the element, i.e.
Bounds - The element should be absolutely positioned.
Flow - The element should flow.
None - No constraint for the element should be supplied here (although a constraint may be inferred from somewhere else, e.g. a template).
BOUNDS
heightThe height of the element. Can be specified in pixels (e.g. 50), as a percentage (e.g. 10%), or as an automatic value based on the size of the content of the element (auto).64
widthThe width of the element. Can be specified in pixels (e.g. 50), as a percentage (e.g. 10%), or as an automatic value based on the size of the content of the element (auto).321
xThe x location of the element, specified as a value in pixels. It is only available when using a Bounds constraint.13
yThe y location of the element, specified as a value in pixels. It is only available when using a Bounds constraint.314

Events

PropertyDescriptionExample
On SelectionIndicates what action to be raised when the specified event occurs.page.userRoleListBox.changed

General

PropertyDescriptionExample
AlignmentControls the alignments of the contained elements or text within the element, selected from a drop down list.CENTRE
Allow Focus?Indicates whether the element will allow focus.true
Allow Multi-Selection?Indicates whether more than one entry can be selected in a list box.true
Auto Advance ExpressionApplies only to ListBox elements. An EL expression which if present is evaluated after a listbox item is selected. If true it causes the next listbox item to be automatically highlighted.xxx
Background ColourThe background colour for the element. It can be shown as the colour name for common colours, e.g. RED, or a hex code, e.g. #ff0000. It could also contain a conditional statement to determine which colour is to be used, e.g. #{notEmpty(view.currentlyInTrainingMode)&& view.currentlyInTrainingMode ? '#80FF80': 'WHITE' }.RED
Background Image URLIndicates the URL for background image to be displayed on the element.Mac1024x768/Pos/PosDialogHoverButton1024x768.gif
Border ColourThe border colour for the element. It can be shown as the colour name for common colours, e.g. RED, or a hex code, e.g. #ff0000. It could also contain a conditional statement to determine which colour is to be used, e.g. #{notEmpty(view.currentlyInTrainingMode)&& view.currentlyInTrainingMode ? '#80FF80': 'WHITE' }.#ff0000
Border SizeIndicates the size of border in pixels. Integer value, 0 means no border.1
Border StyleIndicates the style of the element's borders. Styles are selected from a drop down list.Line
ClassnameAn optional classname that allows the capabilities of the element to be extended.com.enactor.coreUI.swing.pageElementHandlers.
SwingClockLabelElementHandler
ColourThe foreground colour for the element. It can be shown as the colour name for common colours, e.g. RED, or a hex code, e.g. #ff0000. It could also contain a conditional statement to determine which colour is to be used, e.g. #{notEmpty(view.currentlyInTrainingMode)&& view.currentlyInTrainingMode ? '#80FF80': 'WHITE' }.WHITE
Column DefsThe definitions of the columns for the list box. This is done via a pop up window with the following fields:
Alignment - alignment of column contents, e.g. left. Selected from a drop down list.
Start -start point of column, followed by absolute or percentage, depending on requirement.
End - end point of column, followed by absolute or percentage, depending on requirement.
Wrap - a tick indicates that the contents of the column will wrap around.
[1,2,3,Wide3,4,6]
Document Template URLUsed to format the items in the combo/list box for display.Pos/User/UserRoleListTemplate
Enabled?Indicates whether the element is enabled.true
Enabled ExpressionAn expression that determines if the element is enabled. This will take precedence over the Enabled flag. This is entered via a pop up text window.#{size(addressList) > 0}
Focus OrderControls the order the element is tabbed into. Setting to -1 will prevent the element from accepting tab focus.-1
Font NameIndicates the name of font for element, selected via a pop up window, from a drop down list of available fonts.Arial
Font SizeIndicates the size of font for element. Numerical value entered via a pop up window.10
Font StyleIndicates the style of font for element, e.g. bold, italic etc. Selected from list of available styles. The User can set more than one style on the element.[Bold,Underline]
Force Hidden?Indicates whether a component will be hidden despite other visibility checks.true
Hide IntersectingIndicates whether intersecting page elements will hidden when a panel is made visible. Applies to Panel-based elements.false
Horizontal ScrollbarsIndicates whether horizontal scroll bars are to be displayed.None
IdA unique (with the containing element) identifier for this element. It is entered via a pop up window.userRoleListBox
Item Value ExpressionAn expression applied against each element in the list that determines what value is bound to the value.#{item.key.contactTypeId}
List ExpressionAn expression that supplies the list of data for the combo box/list.#{employeeGradesList}
Naming Container?If the element a naming container, i.e. when the ID for child elements is constructed, indicates whether the ID of this element will contribute towards it.true
OptionsControls the list of options displayed in the combo box. This is done via a pop up window with the following fields:
Applicability - indicates when the option is applicable.
Message Base - indicates the location of the messages file containing the required message, e.g. com.enactor.maintenance.resources.UserMaintenanceMessages.
Message ID - the name of the message, as found in the message file in the previous field. Can be either typed in directly, if known, or selected from a drop down list.
Value - If there is no message currently defined, the User can use this field to define a new message.
[BLANK]
Selectable ExpressionAn expression that determines if the item in the combo box/list is selectable.#{listItemVisibilityTest}
Selected Background ColourThe background colour of the item that is selected. It can be shown as the colour name for common colours, e.g. RED, or a hex code, e.g. #ff0000. It could also contain a conditional statement to determine which colour is to be used, e.g. #{notEmpty(view.currentlyInTrainingMode)&& view.currentlyInTrainingMode ? '#80FF80': 'WHITE'}.#FF0000
Selected Foreground ColourThe foreground colour of the item that is selected. It can be shown as the colour name for common colours, e.g. RED, or a hex code, e.g. #ff0000. It could also contain a conditional statement to determine which colour is to be used, e.g. #{notEmpty(view.currentlyInTrainingMode)&& view.currentlyInTrainingMode ? '#80FF80': 'WHITE'}.WHITE
Selected IndexThe index of the item that is selected.0
Skip Page Validation?Indicates whether page validation will be skipped for this element.false
Start With First Item ExpressionAn expression that determines if the ListBox should start with the first element selected. Applies only to ListBox elements.#{true}
Start With Last Item ExpressionAn expression that determines if the ListBox should start with the last element selected. Applies only to ListBox elements.#{false}
StyleThe style for the element. It is entered using a pop up window.vertical-align:top
Style ClassThe style class for the element, entered using a pop up window.removeLink
Transparent BackgroundIndicates whether background of element is transparent.false
ValueThis will vary according to element type.
For display only elements it will control the label for the element. For data entry elements it will control the value the element has.
${enactor.mfc.ProductCode}
Vertical ScrollbarsIndicates whether vertical horizontal scroll bars are to be displayed.None
Visibility ExpressionAn expression that determines if the element is visible, according to privileges etc. This will take precedence over the Visible flag. It is entered via a pop up window.#{basket:testAnyVoidFunctionValid()}
Visible?Indicates whether the element is visible.true
Visible Item CountThe number of items that are visible in the list box.0

List Template Constraints

For all the 'Allow' properties below, the User can select either inherit (i.e. use the associated template values), true or false.

PropertyDescriptionExample
Allow Change Bounds?Indicates whether the bounds of the element can be changed.Inherit
Allow Creation?Indicates whether new child elements can be added to the element.Inherit
Allow Edit?Indicates whether the properties of the element can be modified.Inherit
Allow RemovalIndicates whether the properties of the element can be removed.Inherit
Allow Replacement?Indicates whether child elements that were contributed by the template can be replaced with other elements.Inherit

Template Constraints

For all the 'Allow' properties below, the User can select either inherit (i.e. use the associated template values), true or false.

PropertyDescriptionExample
Allow Bounds to Change?Indicates whether the bounds of the element can be changed.Inherit
Allow Edit?Indicates whether the properties of the element can be modified.Inherit
Allow Removal?Indicates whether the properties of the element can be removed.Inherit
Allow Replacement?Indicates whether child elements that were contributed by the template can be replaced with other elements.Inherit
Render ModeIndicates the mode of rendering for the page definition and affects when an element is drawn. It is selected from a drop down list, i.e. At Initialisation, Whenever Rendered or Use Template.Whenever Rendered