FileDialog QML Type

Une boîte de dialogue de fichier native. En savoir plus...

Ce type est obsolète depuis Qt Labs Platform 6.9. Nous déconseillons fortement de l'utiliser dans du nouveau code.

• Liste de tous les membres, y compris les membres hérités

Propriétés

• 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

Description détaillée

Utilisez plutôt ` QtQuick.Dialogs FileDialog `.

Le type FileDialog fournit une API QML pour les boîtes de dialogue de fichiers natives de la plateforme.

Pour afficher une boîte de dialogue de fichiers, créez une instance de FileDialog, définissez les propriétés souhaitées, puis appelez la méthode open(). Les propriétés currentFile ou currentFiles permettent de déterminer le ou les fichiers actuellement sélectionnés dans la boîte de dialogue. Les propriétés file et files ne sont mises à jour qu’une fois la sélection finale effectuée, c’est-à-dire après avoir validé la boîte de dialogue.

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

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

MyDocument {
    id: document
    source: fileDialog.file
}

Disponibilité

Une boîte de dialogue de fichiers native est actuellement disponible sur les plateformes suivantes :

• Android
• iOS
• Linux (lorsqu’il s’exécute avec le thème de la plateforme GTK+)
• macOS
• Windows

Le module Qt Labs Platform utilise Qt Widgets comme solution de secours sur les plateformes ne disposant pas d’une implémentation native. Par conséquent, les applications utilisant des types du module Qt Labs Platform doivent être liées à QtWidgets et utiliser QApplication au lieu de QGuiApplication.

Pour lier votre application à la bibliothèque QtWidgets, ajoutez ce qui suit à votre fichier de projet qmake :

QT += widgets

Créez une instance de QApplication dans 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();
}

Voir également QtQuick.Dialogs::FileDialog, FolderDialog et StandardPaths.

Documentation sur les propriétés

acceptLabel : string

Cette propriété contient le texte de l'étiquette affiché sur le bouton permettant de valider la boîte de dialogue.

Lorsqu’elle est définie sur une chaîne vide, le libellé par défaut de la plateforme sous-jacente est utilisé. Le libellé par défaut est généralement « Open » ou « Save », selon l’ fileMode e dans laquelle la boîte de dialogue est utilisée.

La valeur par défaut est une chaîne vide.

Voir également rejectLabel.

currentFile : url

Cette propriété contient le fichier actuellement sélectionné dans la boîte de dialogue.

Contrairement à la propriété ` file `, la propriété ` currentFile ` est mise à jour pendant que l'utilisateur sélectionne des fichiers dans la boîte de dialogue, avant même que la sélection finale n'ait été effectuée.

Voir également file et currentFiles.

currentFiles : list<url>

Cette propriété contient les fichiers actuellement sélectionnés dans la boîte de dialogue.

Contrairement à la propriété ` files `, la propriété ` currentFiles ` est mise à jour pendant que l'utilisateur sélectionne des fichiers dans la boîte de dialogue, avant même que la sélection finale n'ait été effectuée.

Voir également files et currentFile.

defaultSuffix : string

Cette propriété contient un suffixe qui est ajouté aux fichiers sélectionnés pour lesquels aucun suffixe n'a été spécifié. Le suffixe sert généralement à indiquer le type de fichier (par exemple, « txt » indique un fichier texte).

Si le premier caractère est un point ('.'), celui-ci est supprimé.

file : url

Cette propriété contient le fichier final accepté.

Contrairement à la propriété « currentFile », la propriété « file » n’est pas mise à jour pendant que l’utilisateur sélectionne des fichiers dans la boîte de dialogue, mais uniquement une fois la sélection finale effectuée. Autrement dit, lorsque l’utilisateur a cliqué sur « OK » pour valider un fichier. Il est également possible de gérer le signal « accepted() » pour obtenir la sélection finale.

Voir également currentFile et accepted().

fileMode : enumeration

Cette propriété détermine le mode de la boîte de dialogue.

Valeurs disponibles :

files : list<url>

Cette propriété contient les fichiers finalement acceptés.

Contrairement à la propriété « currentFiles », la propriété « files » n'est pas mise à jour pendant que l'utilisateur sélectionne des fichiers dans la boîte de dialogue, mais uniquement une fois la sélection finale effectuée. Autrement dit, lorsque l'utilisateur a cliqué sur « OK » pour valider les fichiers. Il est également possible de gérer le signal « accepted() » pour obtenir la sélection finale.

Voir également currentFiles et accepted().

folder : url

Cette propriété contient le dossier dans lequel les fichiers sont sélectionnés. Pour sélectionner un dossier, utilisez plutôt FolderDialog.

Voir également FolderDialog.

nameFilters : list<string>

Cette propriété contient les filtres qui limitent les types de fichiers pouvant être sélectionnés.

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

Voir également selectedNameFilter.

options : flags

Cette propriété regroupe les différentes options qui influent sur l'apparence et le comportement de la boîte de dialogue.

Par défaut, toutes les options sont désactivées.

Les options doivent être définies avant l’affichage de la boîte de dialogue. Leur configuration alors que la boîte de dialogue est visible n’est pas garantie d’avoir un effet immédiat sur celle-ci (selon l’option et la plateforme).

Options disponibles :

rejectLabel : string

Cette propriété contient le texte de l'étiquette affichée sur le bouton permettant de fermer la boîte de dialogue.

Lorsqu'elle est définie sur une chaîne vide, le libellé par défaut de la plateforme sous-jacente est utilisé. Le libellé par défaut est généralement « Cancel ».

La valeur par défaut est une chaîne vide.

Voir également acceptLabel.

selectedNameFilter group

Ces propriétés contiennent le filtre de nom actuellement sélectionné.

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

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

Voir également nameFilters.