Use the Dropdown control to display a list of options, from which the user can select a single option. The list of options can be defined in a list bound to a property, or a clipboard page, a data page, or a report definition.
When the source is a clipboard page, data page, or a report definition, you can categorize items within the drop-down list.
When a drop-down list is bound to a data page or report definition that accepts parameters and the parameter value uses a property reference, the drop-down list automatically refreshes with new items whenever the property value changes. No additional configuration is required. This can be used to set up cascading drop-down menus or any combination of controls.
Upgrading to use the pxDropdown control
The Dropdown control in the Pickers list replaces the deprecated Select control. As a best practice, upgrade PromptSelect and DynamicSelect controls to drop-down controls.
If a section contains PromptSelect, DynamicSelect, or another control for which there is an improved alternative, a warning displays, along with an Update Controls button. Click Update Controls to automatically update deprecated controls in the section.
Adding a drop-down control
- On the Design tab, from the Pickers
list, drag Dropdown onto the work area.
If you are using a cell-based layout and you drag the control into a cell that is not empty, then the dropped control replaces the current contents of the cell.
- Click the View properties icon to display the Properties panel.
- On the Properties panel, define the drop-down list using the following tabs:
The UI Gallery landing page contains a working example of this element. To display the gallery, in Dev Studio, click.
Copying, deleting, or moving a drop-down control
To move a drop-down control, hold down the
SHIFTkey, select the drop-down in the layout and drag and drop it in the new location.
- To cut, copy, or paste a drop-down control in a layout, right-click the control to access a context-menu.
- Dropdown control Properties - General tab
Click the View properties icon in the layout containing the drop-down control ( pxDropdown ) to display the Properties panel, and then select the General tab to define the source of values in the drop-down list.
- Dropdown control Properties - Presentation tab
Click the View properties icon in the layout containing the drop-down control ( pxDropdown ) to display the Properties panel, and then select the Presentation tab to configure the display of the drop-down list.