FolderDialog QML Type

Une boîte de dialogue de dossier 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
• currentFolder : url
• folder : url
• options : flags
• rejectLabel : string

Description détaillée

Utilisez plutôt ` QtQuick.Dialogs FolderDialog `.

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

Pour afficher une boîte de dialogue de dossiers, créez une instance de FolderDialog, définissez les propriétés souhaitées, puis appelez la méthode open(). La propriété currentFolder permet de déterminer le dossier actuellement sélectionné dans la boîte de dialogue. La propriété folder n’est mise à 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: folderDialog.open()
}

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

MyViewer {
    id: viewer
    folder: folderDialog.folder
}

Disponibilité

Une boîte de dialogue de dossiers 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 qui utilisent 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::FolderDialog, FileDialog 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 ».

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

Voir également « rejectLabel ».

currentFolder : url

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

Contrairement à la propriété « folder », la propriété « currentFolder » est mise à jour au fur et à mesure que l'utilisateur sélectionne des dossiers dans la boîte de dialogue, avant même que la sélection finale ne soit effectuée.

Voir également folder.

folder : url

Cette propriété contient le dossier final retenu.

Contrairement à la propriété currentFolder, la propriété folder n’est pas mise à jour pendant que l’utilisateur sélectionne des dossiers 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 dossier. Il est également possible de gérer le signal accepted() pour obtenir la sélection finale.

Voir également currentFolder et accepted().

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 définition alors que la boîte de dialogue est visible ne garantit pas 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 qui s'affiche 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.