Skip to content

FilePicker

Native open/save/folder dialogs for QML (no QtQuick.Dialogs).

import QWinUI3.Platform · src/platform/QWinUI3/Platform/FilePicker.h

Category: Platform · Library: v2.80 · C++ type · singleton

← Component index

Gallery: System integrationsrc/gallery/pages/SystemIntegrationPage.qml

Extends QObject.

Example

FilePicker.openFile(qsTr("Open"), ["All (*.*)"], function (path) {  }, Window.window)

Cancel  empty string / empty array. Pass parent Window for modal ownership
(Windows HWND; Linux portal parent_window on X11 / best-effort Wayland).
Linux: when parentWindow is omitted, focus/visible window is used (2.57).
See docs/system-integration.md · docs/platform-linux-wayland.md (1.68).

API

Properties

No additional properties beyond the base type.

Signals

No custom signals (use inherited signals from the base type).

Methods

Signature Description
`openFile(const QString &title, const QVariantList &nameFilters,
const QJSValue &callback, QObject *parentWindow = nullptr)`
`openFiles(const QString &title, const QVariantList &nameFilters,
const QJSValue &callback, QObject *parentWindow = nullptr)`
`saveFile(const QString &title, const QVariantList &nameFilters,
const QJSValue &callback, const QString &defaultSuffix = QString(),
QObject *parentWindow = nullptr)`
`openFolder(const QString &title, const QJSValue &callback,
QObject *parentWindow = nullptr)`

Generated from module sources by scripts/generate_component_docs.py — do not edit by hand.