FolderDialog QML Type

Ein nativer Ordner-Dialog. Mehr...

Import Statement:	`import Qt.labs.platform`
Inherits:	Dialog

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

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 aktuell ausgewählten Ordner im Dialog zu bestimmen. Die Eigenschaft folder wird erst dann aktualisiert, wenn die endgültige Auswahl durch Akzeptieren des Dialogs getroffen wurde.

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

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

MyViewer {
    id: viewer
    folder: folderDialog.folder
}

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

Das Qt Labs Platform Modul verwendet Qt Widgets als Fallback auf Plattformen, für die keine native Implementierung verfügbar ist. Daher sollten Anwendungen, die Typen aus dem Qt Labs Platform Modul verwenden, mit QtWidgets verknüpft werden und QApplication anstelle von QGuiApplication verwenden.

Um gegen die QtWidgets-Bibliothek zu linken, fügen Sie das Folgende zu Ihrer qmake-Projektdatei hinzu:

QT += widgets

Erstellen Sie eine Instanz von QApplication in main():

#include <QApplication>
#include <QQmlApplicationEngine>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    return app.exec();
}

Hinweis: Es ist nicht garantiert, dass Typen in Qt.labs-Modulen in zukünftigen Versionen kompatibel bleiben.

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 einen leeren String 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 aktuell ausgewählten Ordner im Dialogfeld.

Anders als die Eigenschaft folder wird die Eigenschaft currentFolder aktualisiert, während der Benutzer Ordner im Dialogfeld auswählt, auch bevor die endgültige Auswahl getroffen wurde.

Siehe auch folder.

folder : url

Diese Eigenschaft enthält den endgültig akzeptierten Ordner.

Im Gegensatz zur Eigenschaft currentFolder wird die Eigenschaft folder nicht aktualisiert, während der Benutzer Ordner im Dialogfeld auswählt, sondern erst, nachdem die endgültige Auswahl getroffen wurde. Das heißt, wenn der Benutzer auf OK geklickt hat, um einen Ordner zu akzeptieren. Alternativ kann auch das Signal accepted() verarbeitet werden, um die endgültige Auswahl zu erhalten.

Siehe auch currentFolder und accepted().

options : flags

Diese Eigenschaft enthält die verschiedenen Optionen, die das Aussehen des Dialogs 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 von der Plattform).

Verfügbare Optionen:

Konstant	Beschreibung
`FolderDialog.ShowDirsOnly`	Nur Verzeichnisse im Ordnerdialog anzeigen. Standardmäßig werden sowohl Ordner als auch Verzeichnisse angezeigt.
`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.

rejectLabel : string

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

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

Der Standardwert ist eine leere Zeichenkette.

Siehe auch acceptLabel.

© 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.