apps
2024.10
false
Apps User Guide
Automation CloudAutomation Cloud Public SectorAutomation Suite
Last updated Nov 11, 2024

Multiselect Dropdown

You can use arrays to populate the options of a Multiselect Dropdown control.

General

  • List Source - The source for the items to be displayed in the multi select dropdown. Valid data types include arrays of String or Integer, DateTime, DataTable, or arrays of an Object.
  • Column - When the list source is either of type DataTable or an array of an Object, select the specific column(for DataTable data types) or the specific property (for Object arrays).
  • Hint Text - The help text to be displayed at runtime.
  • Default Selected Value- The default values to be displayed at runtime.
  • Tooltip - The text to be displayed when an app user hovers over the control. Use this to provide additional information on the control.
  • Label - The display text of the control.
  • Required - If true, app users must provide data in the control. To mark the control as mandatory at runtime, an asterisk * is added after the label text.
  • Custom error message - The text to be displayed if the Required property is set to true and the control is left empty.

  • Hidden- If true, hides the control at runtime.

  • Disabled - If true, disables the control at runtime.

Events

  • Value changed - Configure what happens when the dropdown values are changed.

Style

  • Control Alignment - By default, inherits the parent alignment. A different alignment other than the parent can be set. To default back to the parent alignment, deselect the overridden options.

    Note: The alignment is dependent on the layout selected for the parent (Vertical vs Horizontal).
  • Label Placement - By default, the label is set to be displayed on top of the control, at the left side. You can place it to the left of the control, on the same line. The Label Width property configures how wide the label should be, and the Space between property sets the distance between the label and the control.
  • Background color - The background color of the control.
  • Font - The font attributes for both the label and the input text, such as font family, size, color, or style (Bold, Italic and Underline). By default, the control inherits the font family of the immediate parent container which is indicated by the keyword "Inherited".

  • Margin - The margin of the control. By default, a margin of 4px is set. Top/Bottom and Left/Right margin properties are combined. These properties can be detached using the Link button at the right side of the Margin section.
  • Size - The width and height of the control. By default, the size is set to auto. To set minimum or maximum values, click the three dot icon (...).

VB properties

VB property

Data type

Description

Tooltip

String

Information text which appears when the user hovers over the Multiselect Dropdown.

LabelString

The label of the Multiselect Dropdown, typically text displayed preceding the control.

HintText

String

Placeholder text displayed inside the Multiselect Dropdown.

SelectedItems

System.Collections.Generic.List(Of Apps.Controls.TabularInitClass)

Currently selected items in the Multiselect Dropdown.

DataSource

Apps.Controls.ListSource(Of Apps.Controls.TabularInitClass)

Data source for the values inside the Multiselect Dropdown.

Value

System.Collections.Generic.List(Of Apps.Controls.TabularInitClass)

Currently selected items in the Multiselect Dropdown.

Required

Boolean

Specifies if the Multiselect Dropdown value is mandatory.

RequiredErrorMessage

String

Message displayed when the Multiselect Dropdown value is required but was not provided.

HiddenBooleanDetermines the visiblity of the Multiselect Dropdown. If set to true, hides the control at runtime.
DisabledBooleanDetermines if the Multiselect Dropdown is interactable. If set to true, disables the Multiselect Dropdown at runtime.

IsValid

Boolean

Checks validity of the Multiselect Dropdown value. If true, indicates it is valid.

Sample Expression

AppsDataSource.from(New List(Of String) From {"Value 1", "Value 2", "Value 3"})

Adds a set of values to the Multiselect Dropdown at runtime.

  • General
  • Events
  • Style
  • VB properties

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.