FolderDialog QML Type

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

• 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 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 affiché dans la boîte de dialogue. La propriété ` selectedFolder ` permet de 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 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

Qt Quick Dialogs utilise une implémentation de type « Qt Quick » comme solution de secours sur les plateformes ne disposant 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é 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 affiché dans la boîte de dialogue.

Voir également selectedFolder.

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

selectedFolder : url

Cette propriété contient le dernier dossier 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, ainsi que lorsque la boîte de dialogue est validée. Il est également possible de gérer le signal ` accepted()` pour obtenir la sélection finale.

Voir également currentFolder et accepted().