Skip to main content
Version: 8.1

Dropdown List Example


Dropdown lists are used when you want to select a single item from a list of options. The Dropdown component is under the Input section of the component palette. Simply drag it on to your window. The most important property of a Dropdown component is the Data property. It is a Dataset that contains one or more rows of data. Each of the rows are different options that you see on the component. Select the Dropdown component and click on the Dataset Viewer " " icon for the Data property to manually add some options.

" "

Data Property's Dataset Modes​

There are three modes you can use the Data property’s dataset: a number/label pair, a single label column, and a code/label pair. Which mode is used depends on what columns are in the Data property’s dataset, and will determine the values of the Selected Value, Selected String Value and Selected Label properties. Any additional columns that are added to the dataset will not affect these properties.

Number/Label Pair​

In the Number/Label Pair mode, the first column of the Dataset is an integer (often an id) and the second column is a string (often a label). The first column is the Value column which is invisible to the user and is usually used in binding. The second column is the Label column and is visible to the user in the dropdown list.

In this example, the dataset has two rows. The Value column includes the integers 1 and 2. Under the Label column, Realtime and Historical are displayed, respectively.

" "

In Preview Mode, select from the list of dropdown options. Notice, you can only see the options in the Label column. Select the Realtime option. Now, under the Data property section, the Selected Value is 1, which is the corresponding integer in the Value column of the dataset. The Selected String Value and the Selected Label both display Realtime, which is the corresponding string in the Label column of the dataset.

" "

Single Label Column​

The Single Label Column mode you can use is a string/string combination which are two columns that are both strings.

  1. In the Dataset Editor, remove the Value column from our example by selecting a cell in that column and clicking on the Vertical Delete " " icon.

  2. Add another column by clicking on the Vertical Add " " icon.

  3. Call the new column 'Code,' set the column position to '0' and make it a 'String.' Click OK. Both columns are now strings.

    " "

  4. Under the 'Code' column enter 'v1' and 'v2.' Click OK.

    " "

    note

    Because we added the 'Code' column in position '0,' the users will see the same two options in the dropdown list: 'Realtime' and 'Historical.' If you see 'v1' and 'v2' instead, that means your 'Code' column is not the first column.

  5. In Preview Mode, click on 'Historical' and you can see the Selected String Value is 'v2' because the value is in the first column and the Selected Label is 'Historical.'

    " "

Code/Label Pair​

The Code/Label Pair mode simply uses a one string column.

  1. In the Dataset Editor, remove the Code column from our example by selecting a cell in that column and clicking on the Vertical Delete " " icon.

  2. You are going to see the same two options in the Dataset Viewer: ‘Realtime’ and ‘Historical.’

    note

    This only applies if there is exactly one column in this dataset.

    " "

  3. In Preview Mode, select the ‘Realtime’ option. You will see the same value in the Selected Label and Selected String Value properties since there is only the one column.

    " "

Setting Dropdown Options​

Now, you can set these dropdown options manually or bind the Data property. In this example, you can take a Dropdown List on the window and bind the Data property using a SQL query.

  1. Select the Dropdown component, and click on the binding " " icon for the Data property.

  2. Select the SQL Query Binding Type and enter a query that brings back an ID and Name from one of your tables in the database.

    " "

  3. Click OK to see all the options that came back from the database.

  4. In Preview Mode, select any one of these options and you can see the Selected Value, Selected String Value, and Selected Label as shown in the following example.

    " "

Displaying Multiple Columns in a Downdown List​

Another feature of the Dropdown List component is you can show more than one column to a user.

  1. Drag another Dropdown component to your window.

  2. Go to the Dataset Viewer and add some options manually. Instead of having only one or two columns you can add as many as you want. The first column needs to be either an integer or a string. Any additional columns will show up in the dropdown.

    1. Open the Dataset View, under Value, enter ‘1’ and ‘2.’

    2. Under Label, enter ‘Realtime’ and ‘Historical.’

    3. Add another column and call it ‘Col3’ in 'Position 2' , and make it a string and click Add Column.

    4. Under Col3, enter ‘This is real time’ and ‘This is historical'.

    5. Click OK.
      " "

  3. In the Property Editor, set the Dropdown Display Mode to ‘Table’ to see both columns.

    " "

  4. Now you can see Label and Col3 and select between those different rows. It’s a nice way to show more information in the Dropdown list. The Selected Value, Selected String Value, and Selected Label properties will behave the same as previous examples ignoring any columns beyond the second.

    " "