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

File Picker

A native file chooser supporting filters, single or multiple selection, and folder state.

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
file_picker "", label: "Import data", filters: ["JSON files (*.json)", "All files (*)"]
API

Component properties

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

pathPath configuration for File Picker.property
pathsPaths configuration for File Picker.property
labelLabel configuration for File Picker.property
placeholderPlaceholder configuration for File Picker.property
titleTitle configuration for File Picker.property
modeMode configuration for File Picker.property
multipleMultiple configuration for File Picker.property
filtersFilters configuration for File Picker.property
current_folderCurrent folder configuration for File Picker.property
default_suffixDefault suffix configuration for File Picker.property
openedOpened configuration for File Picker.property
native_dialogNative dialog configuration for File Picker.property
accept_textAccept text configuration for File Picker.property
cancel_textCancel text configuration for File Picker.property
widthWidth configuration for File Picker.property
heightHeight configuration for File Picker.property
enabledEnabled configuration for File Picker.property
foregroundForeground configuration for File Picker.property
mutedMuted configuration for File Picker.property
backgroundBackground configuration for File Picker.property
border_colorBorder color configuration for File Picker.property
accentAccent configuration for File Picker.property
radiusRadius configuration for File Picker.property
font_familyFont family configuration for File Picker.property
font_sizeFont size configuration for File Picker.property
visibleVisible configuration for File Picker.property
Show 13 shared item properties
opacityscalerotationzfill_widthfill_heightpreferred_widthpreferred_heightminimum_widthminimum_heightmaximum_widthmaximum_heightlayout_alignment
Interaction

Events

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

inputNative event payload
changeNative event payload
acceptNative event payload
rejectNative event payload
openNative event payload
closeNative event payload
folder_changeNative event payload