ColorDialog QML Type

Une boîte de dialogue de couleurs. En savoir plus...

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

Propriétés

• options : flags
• selectedColor : color

Description détaillée

Le type ColorDialog fournit une API QML pour les boîtes de dialogue de couleur.

Pour afficher une boîte de dialogue de couleur, créez une instance de ColorDialog, définissez les propriétés souhaitées, puis appelez la méthode ` open()`. La propriété ` selectedColor ` permet de déterminer la couleur sélectionnée par défaut dans la boîte de dialogue.

MenuItem {
    text: qsTr("Color")
    onTriggered: colorDialog.open()
}

ColorDialog {
    id: colorDialog
    selectedColor: document.color
    onAccepted: document.color = selectedColor
}

MyDocument {
    id: document
}

Disponibilité

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

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

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

Documentation sur les propriétés

options : flags

Cette propriété contient 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 :

selectedColor : color

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

Le signal ` accepted()` peut être géré pour obtenir la sélection finale. Lorsque l'utilisateur a cliqué sur « Open » pour valider une couleur, un gestionnaire de signal pour le signal ` accepted()` peut interroger la propriété `selectedColor` afin d'obtenir la couleur finale sélectionnée par l'utilisateur.

Voir également accepted().