Table Of Contents

Selector Controls (G Dataflow)

Last Modified: August 7, 2018

Create a list that a user can cycle through to make selections.

Types of Selector Controls

Control Description
Ring A ring control is a numeric input that presents a set of choices associated with numeric values.
Enumerated type, or Enum The enum control is an object that presents a set of choices associated with an enumerated data type. The enumerated data type consists of a set of named constants.
Radio Button Group The radio button group control is an object that presents a set of mutually exclusive choices associated with an enumerated data type. The enumerated data type consists of a set of named constants.
Combo Box The combo box control is an object that presents a list of names associated with string values. Users may select from items in a predefined list or enter new values directly, at edit time or run time.
Listbox The listbox control is an object that presents a set of items. Users may select single or multiple items at run time.
Color Selector The color selector control is an object that presents a color selection. Each color corresponds to RGBA color values or a hexadecimal value.

Which Selector Control Should I Use?

Selector controls all contain a list of items from which the user can make a selection.

Control When to Use Examples: E-Commerce Application
Ring

Use a ring when you want to provide a list of choices that represent numeric values. The ring control is a numeric input that allows the user to choose from a list of meaningful, human-readable values instead of numeric values.

If the logic of your program prefers numeric values to string values, use a ring.

You want to present users with a list of product names, each of which corresponds to a unique product number. You can specify the products' numbers as their respective numeric values. You can then cross-reference those numeric values to find the prices of the items.

Enum and Radio Button Group

Use an enum or a radio button group when you want to provide a list of choices associated with an enumerated data type.

If you want your program to deal with a fixed set of constants instead of arbitrary numeric data, use an enum or radio button group.

In general, use a radio button group when you have less than five options for the user to select from. A radio button group can help the user quickly scan the options.

You want to present users with a list of shipping speed options for the item they want to order. The numeric values assigned to each of the options are automatically defined. You cannot edit the numeric values.

You can use the enumerated data type in the enum control to drive the logic of your program. For example, because the names of the choices are part of the data type, you can use them to populate the cases of a Case Structure. This ensures that only valid states are used in your program.

Figure 1. Enum
Figure 2. Radio Button Group
Combo Box

Use a combo box when you want to provide a list of items for users to cycle through while also providing the option to type new values into the menu at edit time or run time.

If the logic of your program requires string values rather than numeric values, use a combo box.

You want to present users with a list of previous shipping addresses, while also allowing them to enter a new shipping address for this purchase.

Listbox

Use a listbox when you want to provide a list of items in which users can select items at run time.

You want to present users with a list of products in which they can select one or more items.

You can also allow users to select zero items by checking the Allow no selection checkbox. For example, you can allow users to deselect all items.

Assigning Specific Values to Selector Controls

Unlike the strings listed in rings, enums, and radio button groups, the strings listed in a combo box and listbox have no numeric representation. Additionally, enums and radio button groups require these numeric values to be sequential, unsigned integer values, while rings allow for much more freedom in assigning a numeric value.

  1. Select the control to which you want to assign specific values.
  2. On the Item tab, in the Items group, assign and arrange specific values as desired.

Enabling a Combo Box to Accept New Values from the User at Edit Time or Run Time

  1. Select the combo box control.
  2. On the Item tab, in the Items group, select Allow entry of unlabeled values.

Recently Viewed Topics