A list in which the user can select one or multiple items.

Description

A List Box control always shows all available choices (unlike a Drop down control) and in which the user can choose more than one item at a time (unlike a Radio control).

Key properties

Default – The initial value of a control before it is changed by the user.

Items – The source of data that appears in a control such as a gallery, a list, or a chart.

Items The source of data that appears in a control such as a gallery, a list, or a chart.

When you add a gallery, a list, or a chart, the property list shows Items by default so that you can easily specify the data that the new control should show. For example, you might set the Items property of a gallery to the Account table in Salesforce, a table named Inventory that you created in Excel and uploaded to the cloud, or a SharePoint list named ConferenceSpeakers.

Additional properties

BorderColor – The color of a control's border.

BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness – The thickness of a control's border.

FocusedBorderThickness – The thickness of the control's border when it has keyboard focus.

Color – The color of text in a control.

Disabled – Whether the user can interact with the control.

DisabledBorderColor – The color of a control's border if the control's Disabled property is set to true.

DisabledColor – The color of text in a control if its Disabled property is set to true.

DisabledFill – The background color of a control if its Disabled property is set to true.

Fill – The background color of a control.

Font – The name of the family of fonts in which text appears.

FontWeight – The weight of the text in a control: Bold, Semibold, Normal, or Lighter.

Height – The distance between a control's top and bottom edges.

HoverBorderColor – The color of a control's border when the user keeps the mouse pointer on that control.

HoverColor – The color of the text in a control when the user keeps the mouse pointer on it.

HoverFill – The background color of a control when the user keeps the mouse pointer on it.

Italic – Whether the text in a control is italic.

ItemPaddingLeft – The distance between text in a listbox and its left edge.

LineHeight – The distance between, for example, lines of text or items in a list.

OnChange – How the app responds when the user changes the value of a control (for example, by adjusting a slider).

OnSelect – How the app responds when the user taps or clicks a control.

PaddingBottom – The distance between text in a control and the bottom edge of that control.

PaddingLeft – The distance between text in a control and the left edge of that control.

PaddingRight – The distance between text in a control and the right edge of that control.

PaddingTop – The distance between text in a control and the top edge of that control.

PressedBorderColor – The color of a control's border when the user taps or clicks that control.

PressedColor – The color of text in a control when the user taps or clicks that control.

PressedFill – The background color of a control when the user taps or clicks that control.

Reset – Whether a control reverts to its default value.

SelectionColor – The text color of a selected item or items in a list or the color of the selection tool in a pen control.

SelectionFill – The background color of a selected item or items in a list or a selected area of a pen control.

SelectMultiple – Whether a user can select more than one item in a listbox.

Size – The font size of the text that appears on a control.

Strikethrough – Whether a line appears through the text that appears on a control.

TabIndex – Customizes the tab order of controls at runtime when set to a non-zero value.

Tooltip – Explanatory text that appears when the user hovers over a control.

Underline – Whether a line appears under the text that appears on a control.

Visible – Whether a control appears or is hidden.

Width – The distance between a control's left and right edges.

X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).

Related functions

Distinct( DataSource, ColumnName )

Example

  1. Add a List box control, name it CategoryList, and set its Items property to this formula:
    ["Carpet","Hardwood","Tile"]

    Don't know how to add, name, and configure a control?

    Flooring categories in listbox

  2. Add three Drop down controls, move them under CategoryList, and name them CarpetList, HardwoodList, and TileList.

  3. Set the Items property of each Drop down control to one of these values:

    • CarpetList: ["Caserta Stone Beige","Ageless Beauty Clay", "Lush II Tundra"]
    • HardwoodList: ["Golden Teak","Natural Hickory", "Victoria Mahogany"]
    • TileList: ["Honey Onyx Marble","Indian Autumn Slate", "Panaria Vitality Ceramic"]

    Flooring names in dropdown lists

  4. Set the Visible property of each Drop down control to one of these values:

    • CarpetList: If("Carpet" in CategoryList.SelectedItems.Value, true)
    • HardwoodList: If("Hardwood" in CategoryList.SelectedItems.Value, true)
    • TileList: If("Tile" in CategoryList.SelectedItems.Value, true)

    Want more information about the If function or other functions?

  5. Press F5, and then choose one or more items in CategoryList.

    The appropriate Drop down control or controls appear based on your choice or choices.

    Flooring names in dropdown lists

  6. (optional) Press Esc to return to the default workspace.