FolderDialog QML Type

Ein nativer Ordnerdialog. Mehr...

• Liste aller Elemente, einschließlich vererbter Elemente

Eigenschaften

• acceptLabel : string
• currentFolder : url
• options : flags
• rejectLabel : string
• selectedFolder : url

Ausführliche Beschreibung

Der Typ „FolderDialog“ stellt eine QML-API für native Plattform-Ordnerdialoge bereit.

Um einen Ordnerdialog anzuzeigen, erstellen Sie eine Instanz von `FolderDialog`, legen Sie die gewünschten Eigenschaften fest und rufen Sie ` open()` auf. Mit der Eigenschaft ` currentFolder ` lässt sich der Ordner ermitteln, der derzeit im Dialog angezeigt wird. Mit der Eigenschaft ` selectedFolder ` lässt sich der zuletzt im Dialog ausgewählte Ordner ermitteln.

MenuItem {
    text: qsTr("Open...")
    onTriggered: folderDialog.open()
}

FolderDialog {
    id: folderDialog
    currentFolder: StandardPaths.standardLocations(StandardPaths.PicturesLocation)[0]
    selectedFolder: viewer.folder
}

MyViewer {
    id: viewer
    folder: folderDialog.selectedFolder
}

Verfügbarkeit

Ein plattformnativer Ordnerdialog ist derzeit auf den folgenden Plattformen verfügbar:

• Android
• iOS
• Linux (bei Verwendung des GTK+-Plattformthemas)
• macOS
• Windows

Qt Quick Dialogs verwendet eine „ Qt Quick “-Implementierung als Fallback auf Plattformen, auf denen keine native Implementierung verfügbar ist.

Siehe auch „ FileDialog “ und „ StandardPaths “.

Dokumentation zu den Eigenschaften

acceptLabel : string

Diese Eigenschaft enthält den Beschriftungstext, der auf der Schaltfläche angezeigt wird, mit der der Dialog geschlossen wird.

Wird hier eine leere Zeichenfolge festgelegt, wird die Standardbezeichnung der zugrunde liegenden Plattform verwendet. Die Standardbezeichnung lautet in der Regel „ Open “.

Der Standardwert ist eine leere Zeichenfolge.

Siehe auch „ rejectLabel “.

currentFolder : url

Diese Eigenschaft enthält den Ordner, der derzeit im Dialogfeld angezeigt wird.

Siehe auch „ selectedFolder “.

options : flags

Diese Eigenschaft enthält die verschiedenen Optionen, die das Erscheinungsbild des Dialogfelds beeinflussen.

Standardmäßig sind alle Optionen deaktiviert.

Die Optionen sollten vor dem Anzeigen des Dialogfelds festgelegt werden. Wenn sie erst während der Anzeige des Dialogfelds festgelegt werden, ist nicht garantiert, dass sie sich sofort auf das Dialogfeld auswirken (abhängig von der Option und der Plattform).

Verfügbare Optionen:

rejectLabel : string

Diese Eigenschaft enthält den Beschriftungstext, der auf der Schaltfläche angezeigt wird, mit der der Dialog geschlossen wird.

Wird hier eine leere Zeichenfolge angegeben, wird die Standardbezeichnung der zugrunde liegenden Plattform verwendet. Die Standardbezeichnung lautet in der Regel „ Cancel “.

Der Standardwert ist eine leere Zeichenfolge.

Siehe auch „ acceptLabel “.

selectedFolder : url

Diese Eigenschaft enthält den zuletzt im Dialogfeld ausgewählten Ordner.

Der Wert dieser Eigenschaft wird jedes Mal aktualisiert, wenn der Benutzer im Dialogfeld einen Ordner auswählt, sowie beim Bestätigen des Dialogfelds. Alternativ kann das Signal ` accepted()` abgefangen werden, um die endgültige Auswahl abzurufen.

Siehe auch „ currentFolder “ und „ accepted()“.