FileDialog QML Type

Ein Dateidialog. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder
• Veraltete Mitglieder

Eigenschaften

• acceptLabel : string
• currentFolder : url
• defaultSuffix : string
• fileMode : enumeration
• nameFilters : list<string>
• options : flags
• rejectLabel : string
• selectedFile : url
• selectedFiles : list<url>
• selectedNameFilter
  • selectedNameFilter.extensions : list<string>
  • selectedNameFilter.globs : list<string>
  • selectedNameFilter.index : int
  • selectedNameFilter.name : string

Ausführliche Beschreibung

Der Typ „FileDialog“ stellt eine QML-API für 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 der Eigenschaft „ currentFolder “ kann der Ordner festgelegt werden, in dem der Dialog geöffnet wird. Mit den Eigenschaften „ selectedFile “ und „ selectedFiles “ lässt sich festlegen, welche Datei(en) beim Öffnen des Dialogs ausgewählt sind; diese Eigenschaften werden außerdem aktualisiert, wenn der Benutzer im Dialog eine Datei auswählt und wenn der Dialog bestätigt wird.

import QtCore
import QtQuick
import QtQuick.Controls
import QtQuick.Dialogs

ApplicationWindow {
    width: 640
    height: 480
    visible: true

    header: ToolBar {
        Button {
            text: qsTr("Choose Image...")
            onClicked: fileDialog.open()
        }
    }

    Image {
        id: image
        anchors.fill: parent
        fillMode: Image.PreserveAspectFit
    }

    FileDialog {
        id: fileDialog
        currentFolder: StandardPaths.standardLocations(StandardPaths.PicturesLocation)[0]
        onAccepted: image.source = selectedFile
    }
}

Verfügbarkeit

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

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

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

Siehe auch „ 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 festgelegt, wird die Standardbezeichnung der zugrunde liegenden Plattform verwendet. Die Standardbezeichnung lautet in der Regel „ Open “ oder „ Save “, je nachdem, in welcher „ fileMode “ der Dialog verwendet wird.

Der Standardwert ist eine leere Zeichenkette.

Siehe auch „ rejectLabel “.

currentFolder : url

Diese Eigenschaft gibt den Ordner an, in dem Dateien ausgewählt werden. Sie kann so festgelegt werden, dass sie das Startverzeichnis steuert, das beim Öffnen des Dialogfelds angezeigt wird.

Verwenden Sie zur Auswahl eines Ordners stattdessen „ FolderDialog “.

defaultSuffix : string

Diese Eigenschaft enthält eine Dateiendung, die ausgewählten Dateien hinzugefügt wird, für die keine Dateiendung angegeben wurde. 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.

fileMode : enumeration

Diese Eigenschaft gibt den Modus des Dialogfelds an.

Mögliche Werte:

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)"]
}

Verschiedene Plattformen können die auswählbaren Dateien auf unterschiedliche Weise einschränken. Beispielsweise deaktiviert macOS Dateieinträge, die nicht den Filtern entsprechen, während Windows sie ausblendet.

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

Siehe auch „ acceptLabel “.

selectedFile : url

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

Sie kann so festgelegt werden, dass sie die Datei steuert, die beim Öffnen des Dialogs ausgewählt ist.

Wenn mehrere Dateien ausgewählt sind, bezieht sich diese Eigenschaft auf die erste Datei.

Der Wert dieser Eigenschaft wird jedes Mal aktualisiert, wenn der Benutzer im Dialogfeld eine Datei auswählt und wenn der Dialog bestätigt wird. Verarbeiten Sie das Signal „ accepted()“, um die endgültige Auswahl abzurufen.

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

selectedFiles : list<url>

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

Der Wert dieser Eigenschaft wird jedes Mal aktualisiert, wenn der Benutzer im Dialogfeld Dateien auswählt, sowie beim Bestätigen des Dialogfelds. Verarbeiten Sie das Signal „ accepted()“, um die endgültige Auswahl abzurufen.

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

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