ColorDialog QML Type

Un dialogue sur les couleurs. Plus d'informations...

• 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 couleur, construisez une instance de ColorDialog, définissez les propriétés souhaitées et appelez open(). La propriété selectedColor peut être utilisée pour déterminer la couleur initialement sélectionnée 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 pour plate-forme native est actuellement disponible sur les plates-formes suivantes :

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

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

Documentation sur les propriétés

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 :

selectedColor : color

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

Le signal accepted() peut être traité pour obtenir la sélection finale. Lorsque l'utilisateur a cliqué sur Open pour accepter une couleur, un gestionnaire de signal pour le signal accepted() peut interroger la propriété selectedColor pour obtenir la couleur finale sélectionnée par l'utilisateur.

Voir aussi accepted().