FileDialog QML Type

Ein nativer Dateidialog. 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
• currentFile : url
• currentFiles : list<url>
• defaultSuffix : string
• file : url
• fileMode : enumeration
• files : list<url>
• folder : url
• nameFilters : list<string>
• options : flags
• rejectLabel : string
• selectedNameFilter
  • selectedNameFilter.extensions : list<string>
  • selectedNameFilter.index : int
  • selectedNameFilter.name : string

Ausführliche Beschreibung

Verwenden Sie stattdessen „ QtQuick.Dialogs FileDialog “.

Der Typ `FileDialog` stellt eine QML-API für native Plattform-Dateidialoge bereit.

Um einen Dateidialog anzuzeigen, erstellen Sie eine Instanz von `FileDialog`, legen Sie die gewünschten Eigenschaften fest und rufen Sie ` open()` auf. Mit den Eigenschaften ` currentFile ` oder ` currentFiles ` können Sie die aktuell im Dialog ausgewählten Dateien ermitteln. Die Eigenschaften ` file ` und ` files ` werden erst aktualisiert, nachdem die endgültige Auswahl durch Bestätigen des Dialogs getroffen wurde.

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

FileDialog {
    id: fileDialog
    currentFile: document.source
    folder: StandardPaths.writableLocation(StandardPaths.DocumentsLocation)
}

MyDocument {
    id: document
    source: fileDialog.file
}

Verfügbarkeit

Ein plattformspezifischer Dateidialog 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::FileDialog, FolderDialog 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 “ oder „ Save “, je nachdem, in welchem „ fileMode “ der Dialog verwendet wird.

Der Standardwert ist eine leere Zeichenkette.

Siehe auch „ rejectLabel “.

currentFile : url

Diese Eigenschaft enthält die aktuell im Dialogfeld ausgewählte Datei.

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

Siehe auch „ file “ und „ currentFiles “.

currentFiles : list<url>

Diese Eigenschaft enthält die aktuell im Dialogfeld ausgewählten Dateien.

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

Siehe auch „ files “ und „ currentFile “.

defaultSuffix : string

Diese Eigenschaft enthält eine Dateiendung, die ausgewählten Dateien hinzugefügt wird, für die keine Dateiendung angegeben ist. Die Dateiendung dient in der Regel dazu, den Dateityp anzugeben (z. B. steht „txt“ für eine Textdatei).

Wenn das erste Zeichen ein Punkt ('.') ist, wird dieser entfernt.

file : url

Diese Eigenschaft enthält die zuletzt akzeptierte Datei.

Im Gegensatz zur Eigenschaft „ currentFile “ wird die Eigenschaft „ file “ nicht aktualisiert, während der Benutzer im Dialogfeld Dateien auswählt, sondern erst, nachdem die endgültige Auswahl getroffen wurde. Das heißt, wenn der Benutzer auf „ OK “ geklickt hat, um eine Datei zu akzeptieren. Alternativ kann das Signal „ accepted()“ abgefangen werden, um die endgültige Auswahl zu erhalten.

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

fileMode : enumeration

Diese Eigenschaft gibt den Modus des Dialogfelds an.

Mögliche Werte:

files : list<url>

Diese Eigenschaft enthält die endgültig akzeptierten Dateien.

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

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

folder : url

Diese Eigenschaft gibt den Ordner an, in dem Dateien ausgewählt werden. Verwenden Sie zur Auswahl eines Ordners stattdessen „FolderDialog“.

Siehe auch „ FolderDialog “.

nameFilters : list<string>

Diese Eigenschaft enthält die Filter, die die Auswahl der Dateitypen einschränken.

FileDialog {
    nameFilters: ["Text files (*.txt)", "HTML files (*.html *.htm)"]
}

Siehe auch selectedNameFilter.

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. Es ist nicht garantiert, dass sich das Festlegen der Optionen bei sichtbarem Dialogfeld 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 das Dialogfeld geschlossen wird.

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

Der Standardwert ist eine leere Zeichenkette.

Siehe auch „ acceptLabel “.

selectedNameFilter group

Diese Eigenschaften enthalten den aktuell ausgewählten Namensfilter.

FileDialog {
    id: fileDialog
    selectedNameFilter.index: 1
    nameFilters: ["Text files (*.txt)", "HTML files (*.html *.htm)"]
}

MyDocument {
    id: document
    fileType: fileDialog.selectedNameFilter.extensions[0]
}

Siehe auch nameFilters.