Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This pageA ComboBox graphical element allows users to select items from a predefined list.

On this page:

Table of Contents
maxLevel3
styleNone


Requirements

This components runs only  on Windows, on RichClient and SmartClient clients. component is Portable. It runs both on Windows and on Web Pages hosted in any platform.


Configuration

  1. Go to Displays / Draw.
  2. On the Components Panel, select Interaction, then ComboBox.
  3. Click or drag-and-drop it on the Drawing area to use it.
  4. Double-click the component to open the configuration window.

Image Added

Configuration


Combo Box Settings

Field

Description

Control Name

Defines a name for the control so it can be accessed in the CodeBehind script. See Display Code Behind

Value

The Tag that will receive the value selected.

PlaceHolder

Message shown before select an object.

DataSource

Data Source.

ReadOnly

Enable Read Only mode.

ComboBox Settings

Field

Description

Selected Index

------------------

Blinding

  • TwoWay

  • OutputOnly

  • InputOnly

Selected Item

------------------

Items Source

  • Text

  • Array

  • Object

IsEditable

Check box for the combobox to be editable. Allows editing only of the values on the items. If Custom values are required the property AllowCustomValues must be set on the code behind script.

IsLegacy

------------------

Max Items

------------------

Reload

------------------

LinkedValue

Specifies the variable or tag to which the ComboBox is bound. Ensures that the selected value in the ComboBox is linked to the specified data source, enabling 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 ComboBox. Allows the application to track the selected item and update other components accordingly.

Items Source

Determines the source of the items displayed in the ComboBox. 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 ComboBox to display a list of simple text items. Useful for representing straightforward string values such as machine states or operational modes.

Array: Allows the ComboBox 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 ComboBox 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.

Is Editable

Allows users to type in the ComboBox to add new items or select existing ones when selected. This feature is useful in scenarios where predefined options are insufficient.

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 ComboBox 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 ComboBox. Ensures that the ComboBox displays the most current data, useful for dynamic or real-time data sources.



Runtime Execution

When users select an item from a combo 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 combo box helps users choose from predefined options, such as a machine type or report format.

Image Added

Tip
iconfalse

Check out our ComboBox from Table to see this control in action

Runtime

In Runtime, the control has embedded controls to allow the Operator to modify the view.

Typically the configuration settings of <> is attached to a Tag exposed in the Display User Interface, allowing the operator to select <. >

.



In this section:

Page Tree
root@parent
spacesV10