This document covers the following topics:
A selection box item is an item inside a selection box control.
The selection box items are added to the list box control either by specifying them in the dialog editor's selection box attributes window, or by using the PROCESS GUI statement actions ADD-ITEMS, ADD-ITEMS-EX or ADD. You can find out the selected item by querying the STRING attribute of the selection box control.
Items created using the dialog editor are represented in a Natural variable. The variable name is generated as: selection-box-handle-name -ITEMS (1: number-of-selection-box-items). Example: #SB-1-ITEMS (1:5). The fifth item would then be called: #SB-1-ITEMS (5).
Items created with the PROCESS GUI statement actions can be given any variable name in the HANDLE definitions.
Example: #MYITEM-1 HANDLE OF SELECTIONBOXITEM.
A selection box item does not receive any events. Instead, the selection box control receives them, triggering event handlers there.
| Attribute Name | Query | Set/Modify | In Attr. Window |
|---|---|---|---|
| BACKGROUND-COLOUR-NAME | X | X/X | X |
| BACKGROUND-COLOUR-VALUE | X | X/X | X |
| CLIENT-DATA | X | X/X | |
| CLIENT-HANDLE | X | X/X | |
| CLIENT-KEY | X | X/X | |
| CLIENT-VALUE | X | X/X | |
| DIL-TEXT | X | X/X | X |
| FIRST-CHILD | X | -/- | |
| FOREGROUND-COLOUR-NAME | X | X/X | X |
| FOREGROUND-COLOUR-VALUE | X | X/X | X |
| LAST-CHILD | X | -/- | |
| PARENT | X | X/- | |
| PREDECESSOR | X | -/- | |
| SELECTED | X | X/X | |
| STRING | X | X/X | X |
| SUCCESSOR | X | X/- | |
| TYPE | X | X/- |
This dialog element does not create events.