FolderDialog QML Type

Ein nativer Ordnerdialog. Mehr...

Dieser Typ ist seit Qt Labs Platform 6.9 veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Ausführliche Beschreibung

Verwenden Sie stattdessen „ QtQuick.Dialogs FolderDialog “.

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 ` kann der aktuell im Dialog ausgewählte Ordner ermittelt werden. Die Eigenschaft ` folder ` wird erst aktualisiert, nachdem die endgültige Auswahl durch Bestätigen 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 plattformnativer Ordnerdialog ist derzeit auf den folgenden Plattformen verfügbar:

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

Das Modul „ Qt Labs Platform “ verwendet „ Qt Widgets “ als Fallback auf Plattformen, auf denen keine native Implementierung verfügbar ist. Daher sollten Anwendungen, die Typen aus dem Modul „ Qt Labs Platform “ verwenden, eine Verknüpfung zu „ QtWidgets “ herstellen und „ QApplication “ anstelle von „ QGuiApplication “ verwenden.

Um eine Verknüpfung mit der Bibliothek „ QtWidgets “ herzustellen, fügen Sie Folgendes in Ihre qmake-Projektdatei ein:

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();
}

Siehe auch QtQuick.Dialogs::FolderDialog, 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 angegeben, wird die Standardbezeichnung der zugrunde liegenden Plattform verwendet. Die Standardbezeichnung lautet in der Regel „ Open “.

Der Standardwert ist eine leere Zeichenkette.

Siehe auch „ rejectLabel “.

currentFolder : url

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

Im Gegensatz zur Eigenschaft „ folder “ wird die Eigenschaft „ currentFolder “ aktualisiert, während der Benutzer im Dialogfeld Ordner auswählt, noch bevor die endgültige Auswahl getroffen wurde.

Siehe auch „ folder “.

folder : url

Diese Eigenschaft enthält den zuletzt akzeptierten Ordner.

Im Gegensatz zur Eigenschaft „ currentFolder “ wird die Eigenschaft „ folder “ nicht aktualisiert, während der Benutzer im Dialogfeld Ordner 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 das Signal „ accepted()“ abgefangen werden, um die endgültige Auswahl zu erhalten.

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

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 festgelegt werden, während das Dialogfeld bereits sichtbar ist, ist nicht garantiert, dass sich dies sofort auf das Dialogfeld auswirkt (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 “.