FolderDialog QML Type

Ein nativer Ordner-Dialog. Mehr...

Import Statement:	`import QtQuick.Dialogs`
Since:	Qt 6.3
Inherits:	Dialog

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Detaillierte Beschreibung

Der FolderDialog-Typ bietet eine QML-API für plattformspezifische Ordnerdialoge.

Um einen Ordnerdialog anzuzeigen, konstruieren Sie eine Instanz von FolderDialog, setzen die gewünschten Eigenschaften und rufen open() auf. Die Eigenschaft currentFolder kann verwendet werden, um den Ordner zu bestimmen, der gerade im Dialog angezeigt wird. Die Eigenschaft selectedFolder kann verwendet werden, um den zuletzt im Dialog ausgewählten Ordner zu 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 plattformeigener Ordnerdialog ist derzeit auf den folgenden Plattformen verfügbar:

Android
iOS
Linux (wenn mit dem GTK+-Plattformthema ausgeführt)
macOS
Windows

Qt Quick Dialogs verwendet eine Qt Quick -Implementierung als Fallback auf Plattformen, für die keine native Implementierung verfügbar ist.

Siehe auch FileDialog und StandardPaths.

Eigenschaft Dokumentation

acceptLabel : string

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

Wenn sie auf eine leere Zeichenfolge gesetzt ist, wird die Standardbeschriftung der zugrunde liegenden Plattform verwendet. Die Standardbeschriftung ist normalerweise Open.

Der Standardwert ist eine leere Zeichenkette.

Siehe auch rejectLabel.

currentFolder : url

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

Siehe auch selectedFolder.

options : flags

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

Standardmäßig sind alle Optionen deaktiviert.

Die Optionen sollten eingestellt werden, bevor das Dialogfeld angezeigt wird. Wenn sie gesetzt werden, während das Dialogfeld sichtbar ist, ist nicht garantiert, dass sie eine unmittelbare Auswirkung auf das Dialogfeld haben (abhängig von der Option und der Plattform).

Verfügbare Optionen:

Konstant	Beschreibung
`FolderDialog.DontResolveSymlinks`	Symlinks im Ordnerdialog nicht auflösen. Standardmäßig werden Symlinks aufgelöst.
`FolderDialog.ReadOnly`	Zeigt an, dass der Dialog das Erstellen von Verzeichnissen nicht zulässt.
`FolderDialog.DontUseNativeDialog`	Erzwingt, dass der Dialog eine nicht-native Quick-Implementierung verwendet.

rejectLabel : string

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

Wenn sie auf eine leere Zeichenkette gesetzt ist, wird die Standardbeschriftung der zugrunde liegenden Plattform verwendet. Die Standardbeschriftung ist normalerweise Cancel.

Der Standardwert ist eine leere Zeichenkette.

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 einen Ordner im Dialog auswählt und wenn der Dialog akzeptiert wird. Alternativ kann auch das Signal accepted() verwendet werden, um die letzte Auswahl zu erhalten.

Siehe auch currentFolder und accepted().

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.