zui docs v0.0.5
GitHub ↗
Buttons and input Native Qt

Dropdown

A labeled native choice control for selecting one value from a compact option list.

Usage

Ruby example

Paste this complete Builder example inside the app surface from the Quickstart. Replace illustrative asset paths with files from your project.

Ruby
dropdown :balanced, label: "Profile", options: %i[quiet balanced performance]
API

Component properties

12 component-specific values, plus shared item and layout properties.

labelLabel configuration for Dropdown.property
valueValue configuration for Dropdown.property
optionsOptions configuration for Dropdown.property
foregroundForeground configuration for Dropdown.property
backgroundBackground configuration for Dropdown.property
popup_borderPopup border configuration for Dropdown.property
accentAccent configuration for Dropdown.property
font_familyFont family configuration for Dropdown.property
row_heightRow height configuration for Dropdown.property
popup_row_heightPopup row height configuration for Dropdown.property
show_labelShow label configuration for Dropdown.property
cursorCursor configuration for Dropdown.property
Show 17 shared item properties
visibleenabledopacityscalerotationzwidthheightfill_widthfill_heightpreferred_widthpreferred_heightminimum_widthminimum_heightmaximum_widthmaximum_heightlayout_alignment
Interaction

Events

Subscribe with on widget, :event and keep behavior in Ruby.

changeNative event payload
hoverNative event payload