FolderDialog QML Type

Une boîte de dialogue de dossier native. Plus d'informations...

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

Propriétés

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

Description détaillée

Le type FolderDialog fournit une API QML pour les boîtes de dialogue de dossiers de la plate-forme native.

Pour afficher une boîte de dialogue de dossier, construisez une instance de FolderDialog, définissez les propriétés souhaitées et appelez open(). La propriété currentFolder peut être utilisée pour déterminer le dossier actuellement affiché dans la boîte de dialogue. La propriété selectedFolder peut être utilisée pour déterminer le dernier dossier sélectionné dans la boîte de dialogue.

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

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

MyViewer {
    id: viewer
    folder: folderDialog.selectedFolder
}

Disponibilité

Une boîte de dialogue de dossier de plate-forme native est actuellement disponible sur les plates-formes suivantes :

• Android
• iOS
• Linux (avec le thème de plateforme GTK+)
• macOS
• Windows

Qt Quick Dialogs utilise une implémentation Qt Quick comme solution de repli sur les plateformes qui ne disposent pas d'une implémentation native.

Voir également FileDialog et StandardPaths.

Documentation sur les propriétés

acceptLabel : string

Cette propriété contient le texte de l'étiquette affichée sur le bouton qui accepte le dialogue.

Lorsqu'elle est définie comme une chaîne vide, l'étiquette par défaut de la plateforme sous-jacente est utilisée. L'étiquette 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 qui est actuellement affiché dans la boîte de dialogue.

Voir aussi selectedFolder.

options : flags

Cette propriété contient les différentes options qui affectent l'aspect et la convivialité de la boîte de dialogue.

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

Les options doivent être définies avant d'afficher la boîte de dialogue. Le fait de les définir alors que la boîte de dialogue est visible ne garantit pas un effet immédiat sur la boîte de dialogue (en fonction de l'option et de la plate-forme).

Options disponibles :

rejectLabel : string

Cette propriété contient le texte de l'étiquette affichée sur le bouton qui rejette le dialogue.

Lorsqu'elle est définie comme une chaîne vide, l'étiquette par défaut de la plateforme sous-jacente est utilisée. L'étiquette par défaut est généralement Cancel.

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

Voir également acceptLabel.

selectedFolder : url

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

La valeur de cette propriété est mise à jour chaque fois que l'utilisateur sélectionne un dossier dans la boîte de dialogue et lorsque la boîte de dialogue est acceptée. Il est également possible de gérer le signal accepted() pour obtenir la sélection finale.

Voir également currentFolder et accepted().