Properties of the COMBO BOX Object

Defines the adjustment of an object placed in the view of a split bar object, when the user drags the horizontal bar below the object, or when he/she resizes the window below and when the split bar expands (VERTICAL_ADJUSTMENT property equal to _SPLT_ADJUST_EXPAND_HEIGHT) and if the object belongs to one of the bottommost views.

Note: This property is not implemented in Java and Mobile generation.

Defines the adjustment of an object placed in the view of a split bar object, when the user drags the vertical bar to the left of the object, or when he/she resizes the window below and when the split bar expands (HORIZONTAL_ADJUSTMENT property equal to _SPLT_ADJUST_EXPAND_WIDTH) and if the object belongs to one of the rightmost views.

Note: This property is not implemented in Java and Mobile generation.

Defines the adjustment of an object placed in the view of a split bar object, when the user drags the vertical bar to the right of the object, or when he/she resizes the window below and when the split bar expands (HORIZONTAL_ADJUSTMENT property equal to _SPLT_ADJUST_EXPAND_WIDTH) and if the object belongs to one of the rightmost views.

Note: This property is not implemented in Java and Mobile generation.

Defines the adjustment of an object placed in the view of a split bar object, when the user drags the horizontal bar above the object, or when he/she resizes the window above and when the split bar expands (VERTICAL_ADJUSTMENT property equal to _SPLT_ADJUST_EXPAND_HEIGHT) and if the object belongs to one of the bottommost views.

Note: This property is not implemented in Java and Mobile generation.

Allows the object to be placed in focus. Objects placed in focus are receptive to actions performed by the user using the keyboard and/or mouse.

Defines whether alphabetical sorting is carried out automatically when adding or changing an element.

Note: When the AUTOMATIC_SORT property is set to *TRUE:

• Using the SORT_LST instruction on the list has no effect.  
• The INSERT_ELT instruction does not take into account any position indicators. Insertion is always carried out according to an ascending alphabetical sort.
• Alphabetical sorting is different from that carried out by the SORT_LST instruction.
• When the user types in the beginning of an element, the list automatically scrolls down/up towards the elements starting with the letters typed in.

This property is not implemented by the Java generator.

Color in which the object's background is displayed.

The property's value represents an RGB color. Each color has red, green and blue components in the range [0 - 255]. The value of the resultant color is calculated as follows: BackgroundColor = B*65536 + G*256 + R. Certain values are predefined using the constants below.

Defines the object type.

Note: This property only takes into account the _CBB_TYPE_DROPDOWN and _CBB_TYPE_DROPDOWN_LIST constants in Java generation.

With droplist combo boxes in which one or more columns have been placed, the COL_NUM_COMBOBOX_VAL property indicates the number of the column whose value corresponds to that of the list. In practice, this property is used to specify which of the columns placed in the combo box during the layout design process is the key column.

When values are assigned using COMBO_BOX:VALUE = 'Value', the first line for which the column indicated by this property matches 'Value' is selected. In addition, the VALUE properties of all the columns are updated with the values from this line.

The first column takes the index 1.

Note: This property is not used by the Java generator.

Allows to manage the list (add, modify an element, browse the list, etc.) if no object of the "COMBO_COLUMN" type is associated with the list.

Specifies the format used to display the object's value.

With simple and dropdown value lists that have a visible column for which an edit code has been specified, the code is adopted as the combo box's edit code. With droplist value lists that have a column corresponding to the list's VALUE property, the edit code assigned to it (if any) is adopted as the combo box's edit code.

Click here for more details on edit codes.

Specifies the format used to display the object's value.

With simple and dropdown combo boxes that have a visible column for which an edit word has been specified, the code is adopted as the combo box's edit code. With droplist value lists that have a column corresponding to the list's VALUE property, the edit code assigned to it (if any) is adopted as the combo box's edit word.

Click here for more details on edit words.

Character font used to display the text in the object.

The string format contains the name, size, style and script, in that order. A semi-colon must be inserted between each element.

If you set a property's value, you MUST specify the name and size.

The different styles are specified using the following values:

• • 1: Normal (no special style)
  • 2: Strikethrough
  • 16: Italics
  • 256: Bold
  • 4096: Underlined

The style value to be specified in the string can either be one of the above values or else the sum of values other than 1.

The different script values are as follows:

Note:

The size, style and script must be compatible with the chosen font. The Windows system font selection dialog box, accessible via the graphical object's Properties pages, provides a guide for selecting coherent values.

Specifies the first object in a group of objects. A group of objects is defined by its first object and all the following objects (following the object sequence) until the first object in another group is reached. The user can use the arrow keys to change focus from one object to another within the same group.

Height value of the object.

Defines how the graphical control is adjusted when the window is resized horizontally.

Note: This property is not implemented in Java and Mobile generation.

Defines the filter used when entering characters.

List of elements.

Height value of the list displaying the object values.

Note: This property is not implemented by the Java generation.

Static name of the object.

Authorizes the object to draw itself over a control positioned in front of it in the window object order.

In the particular case where the window has a background image with transparent images placed in foreground, it is necessary to set the property to *TRUE if you wish to put the object after a "transparent" object in the tab order.

Reminder: an "overlapped" object must be placed after the background image, while a "non-overlapped" object must be placed before the background image.

For more information about managing overlapping of graphical objects, consult the working with object overlap section.

Note: This property is not implemented by the Java and Mobile generators.

Color in which the object's background is displayed in read-only mode.

Note: This property is not implemented in Java generation nor in Mobile generation.

Prevents the object from being entered via the keyboard for "drop down" and "simple" types, prevents the opening of the combo box for "drop down" and "drop list" types, and prevents selection from the list for the type "simple".

Visually, the button allowing you to open the combo box is dimmed. Colors of the text and background respectively depend on READ_TEXT_COLOR and READ_BACKGROUND_COLOR properties.

Color used to draw the text of the object in read-only mode.

Note: This property is not implemented in Java generation nor in Mobile generation.

Allows the object to be placed in focus using the keyboard (TAB key or SHIFT+TAB).

Color in which the text in the object is displayed.

The property's value represents an RGB color. Each color has red, green and blue components in the range [0 - 255]. The value of the resultant color is calculated as follows: BackgroundColor = B*65536 + G*256 + R. Certain values are predefined using the constants below.

Value associated with the display field (or data entry field).

Defines how the graphical control is adjusted when the window is resized vertically.

Note: This property is not implemented in Java and Mobile generation.

Visibility of the object.

Width value of the object.

X coordinate value of the object's position relative to the area covered by the window, page or pane.

The reference point (origin) is the top left corner of the object.

Y coordinate value of the object's position relative to the area covered by the window, page or pane.

The reference point (origin) is the top left corner of the object.

• Page:
  COMBO BOX (Visual Adelia Context)
• Page:
  Events of the COMBO BOX Object
• Page:
  Methods of the COMBO BOX Object
• Page:
  Properties of the COMBO BOX Object