List Box
Allows a user to display a list of preset items. This control allows for single or multiple selections.
The properties on this control are nearly identical to the ones for the List Selection Box, however this is the pared down version and most properties don’t do anything.
Property Group | Property | Description |
---|---|---|
Basic | Id | Unique identifier for the control |
Basic | Label Text | Sets the label within the control. (Fig. A) |
Behavior | On Blur | Click this to create an OnBlur event for the control. On Blur is triggered when the control loses focus. |
Behavior | On Create | Click this to create an OnCreate event for the control On Create is triggered when the control is painted to the GUI. |
Comments | Comments | Add some developer notes to the control. These are not customer-facing and are only visible in App Studio (Fig. B) |
Data | Key Field | Indicates that a bound component is a key field. If true, the field is enabled if there is no current record, allowing the user to select an existing record or create a new one. |
Data | EpBinding | Bind the button to a DataView.Column. Multiple selections will be delimited and stored by their ID. |
Data > Items | Id | Set the unique ID for the items. This is also what is stored in the EpBinding for the control. (Fig. C) |
Data > Items | Text | Set the display text for the item. (Fig. C) |
Data > Items | Id Name | (Obsolete) |
Data > Items | Description | Detailed description for the item. This is internal only. (Fig. D) |
Data > Items | SubText | Doesn’t do anything. |
Data > Items | LeftIcon | Doesn’t do anything. |
Data > Items | Command | Might do something if I could, you know, know what it’s looking for here. What a crap shoot! |
Data > Items | Selected | Set the flag indicating the list item is selected. It shows it in App Studio as selected, but it doesn’t work in the actual application. |
Data > Items | Check Mark Hidden | Hides the checkmark for the item, but still allows for selection. Nothing like confusing your users! (Fig. E) |
Data > Items | Toggle Disabled | Indicates if the list item is disabled. There’s no visual to actually SHOW that it’s disabled, though. Again–nothing like confusing your users! |
Data > Items | Required | This one is neat. /s Sets a flag indicating that the item is required. Yes–it does indicate that. It also doesn’t allow you to click the item nor does it automatically add it to the binding… (Fig. F) |
Data > Items | Bookmark | Set the flag indicating the list item has a bookmark. Doesn’t do anything. |
Layout | Alignment | Set the alignment for the control. Valid options are Left, Center, Right. (Fig. G) |
Layout | Width | Sets the specific width (pixels) for the control. Doesn’t work. |
State | Personalizable | If true, a user can personalize this component(hide/show) |
State | Customizable | If true, a user can customize this component in child layers |
State | Hidden | Hides the control from view. |
State | Disabled | Disables the control. The control will not allow editing or focus. |
State | Read Only | Makes the control read only so that it will not allow editing. The control can still be focused. |
State | Auto Focus | When enabled, the control is automatically focused on creation. |
Advanced | Selection Mode | This determines whether the user can select single or multiple values at once. This defaults to multi-selection mode. Valid options include: single and multi. (Fig. H) |
Advanced | Target Label Text | Set the label text for the target list. Doesn’t do anything. |
Advanced | Mode Types | Set the display mode such as single, dual, or panel. Doesn’t do anything. |
Advanced | Ui Mode | :mag_right Set the UI mode such as select, single-select, or switch. Doesn’t do anything. |
Advanced | Position Mode | Set the position mode (left or right). Doesn’t do anything. |
Advanced | Reorder | Set the reorder mode (All or selected). Doesn’t do anything. |
Advanced | Header | Sets the label text for the list. Only used on Panel Mode and thus–doesn’t do anything. |
Advanced | Limit | Set the limit of the items to be displayed. Only used on Panel Mode and thus–doesn’t do anything. |
Advanced | Rows | Sets the number of items to be displayed. (Fig. I) |
Advanced | Manual Sort | Sets the flag indicating if the Sort button should be shown. Doesn’t work. |
Advanced | Show Edit | Sets the flag indicating if the Edit button should be presented. Panel mode only. Doesn’t work for this control. |
Advanced | Enable Edit | Set the flag indicating if editing of list items is allowed. Panel mode only. Doesn’t work for this control. |
Advanced | Enable Header Edit | Sets the flag indicating if the edit button should be presented at the top of the list. Panel mode only. Doesn’t work for this control. |
Advanced | Value Primitive | Specify the type of selected value. If set to true, the selected value has to be of a primitive value. Not sure what this is supposed to do. Doesn’t seem to change anything. |
Advanced | Delimited | Set the flag indicating if the multi-select value for binding is delimited. It’s delimited regardless of this checkbox. |
Advanced | Delimiter | Set the delimiter character used for the binding. Valid options include: Nothing, “~”, “,”, or “`”. (Fig. J) |
Figure A: Label Text
Figure B: Comments
Figure C: Id and Text
Figure D: Description
Figure E: Checkmark Hidden
Figure F: Required
Figure G: Alignment
Figure H: Selection Mode
Multi
Single
Figure I: Rows
Figure J: Delimiter