Harness and Section forms - Adding a drop-down control

Use the drop-down 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.

You can style the drop-down control in your application skin; see Skin form — Components tab — Controls — Dropdowns.

Upgrading to use the pxDropdown control

The pxDropdown control replaces the deprecated Select control in the Basic control group. 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.

Note: Automatic update is not available for all controls; see Pega Community article Upgrading deprecated and outdated controls.

Adding a drop-down control

  1. From the Basic control group, select the Dropdown control.
  2. Drag the control into the layout and release the mouse button to drop the control.

    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.

  3. Click the View properties icon to display the Properties panel.
  4. 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 Configure > User Interface > Gallery > UI elements.

Copying, deleting, or moving a drop-down control

  • To move a drop-down control, hold down the SHIFT key, 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.

About Flow Actions

About Harnesses

About Sections