A ListBox graphical element allows users to select items from a predefined list.
On this page:
Requirements
This component is Portable. It runs both on Windows and on Web Pages hosted in any platform.
Configuration
After dragging and dropping the component into the Drawing area, double-click it to open the graphical element configuration window.
ListBox Settings | |
---|---|
Field | Description |
LinkedValue | Specifies the variable or tag that the ListBox is bound to. Ensures that the selected value in the ListBox is linked to the specified data source, allowing for dynamic updates and data binding. |
Binding | Sets the binding mode for the component. Options are: TwoWay updates the data source and UI interchangeably; OutputOnly allows data output without user input; InputOnly accepts user input without updating the data source. |
SelectedIndex | Specifies the index of the currently selected item in the ListBox. Allows the application to track the selected item and update other components accordingly. |
Items Source | Determines the source of the items displayed in the ListBox. Can be bound to a list or collection, and users can specify the type of data, such as text or objects. Options are: Text: Allows the ListBox to display a list of simple text items. Useful for representing straightforward string values such as machine states or operational modes. Array: Allows the ListBox to display items from an array. Suitable for predefined sets of options, such as lists of sensor IDs or operational steps, enabling efficient management of uniform data. Object: Allows the ListBox to display items from a collection of objects. Ideal for complex data representation where each item has multiple attributes, such as equipment lists with properties like name, ID, and status. |
Start Index at One | Sets the index counting to start at one instead of zero when checked. Useful for user interfaces where the indexing needs to align with non-programmatic conventions. |
MaxItems | Specifies the maximum number of items that the ListBox can display or hold. Limits the number of items to prevent overload and improve performance. |
Reload | Specifies a command or function that reloads the items in the ListBox. Ensures that the ListBox displays the most current data, useful for dynamic or real-time data sources. |
Runtime Execution
When users select an item from a list box, the application updates to reflect the chosen option. This selection changes the displayed data or configuration settings according to the user's choice. The list box helps users choose from predefined options, such as a machine type or report format.
In this section: