QColorDialog

La classe QColorDialog fournit une boîte de dialogue pour spécifier les couleurs. Plus d'informations...

 #include <QColorDialog>

Héritage

Hérite de QDialog.

Description détaillée

La classe QColorDialog fournit une boîte de dialogue pour spécifier les couleurs.

La fonction de la boîte de dialogue des couleurs est de permettre aux utilisateurs de choisir des couleurs. Par exemple, vous pouvez l'utiliser dans un programme de dessin pour permettre à l'utilisateur de fixer la couleur de la brosse.

Les fonctions statiques fournissent des boîtes de dialogue des couleurs modales.

La fonction statique getColor() affiche la boîte de dialogue et permet à l'utilisateur de spécifier une couleur. Cette fonction peut également être utilisée pour permettre aux utilisateurs de choisir une couleur avec un niveau de transparence : passez l'option ShowAlphaChannel en tant qu'argument supplémentaire. L'utilisateur peut stocker customCount() couleurs personnalisées différentes. Les couleurs personnalisées sont partagées par toutes les boîtes de dialogue des couleurs et mémorisées tout au long de l'exécution du programme. Utilisez setCustomColor() pour fixer les couleurs personnalisées et utilisez customColor() pour les obtenir.

Des widgets additionnels qui peuvent permettre à l'utilisateur de choisir des couleurs sont disponibles dans Qt Solutions.

L'exemple boîtes de dialogue standard montre comment utiliser QColorDialog de la même manière que les autres boîtes de dialogue natives à Qt.

Voir aussi QColor, QFileDialog, QPrintDialog, QFontDialog et exemple de boîtes de dialogue standard.

Type

enum QColorDialog::ColorDialogOptionflags QColorDialog::ColorDialogOptions

Cette énumération spécifie les différentes options qui affectent l'apparence de la boîte de dialogue.

Cette énumération a été introduite ou modifiée dans Qt 4.5.

Le type ColorDialogOptions est un typedef pour QFlags<ColorDialogOption>. Il stocke une combinaison à l'aide du OU logique de valeurs de ColorDialogOption.

Voir aussi options, setOption(), testOption() et windowModality().

Propriétés

currentColor : QColor

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

Fonction d'accès

QColor currentColor () const

void setCurrentColor ( const QColor & color )

Notifier signal:

void currentColorChanged ( const QColor & color )

options : ColorDialogOptions

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

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

Les options devraient être fixées avant d'afficher la boîte de dialogue. Il n'est pas certain d'obtenir un effet immédiat en modifiant les options alors que la boîte de dialogue est visible (cela dépend de l'option et de la plateforme).

Fonction d'accès

ColorDialogOptions options () const

void setOptions ( ColorDialogOptions options )

Voir aussi setOption() et testOption().

Fonctions membres

QColorDialog::QColorDialog ( QWidget * parent = 0 )

Constuit une boîte de dialogue des couleurs avec le parent fourni.

Cette fonction a été introduite dans Qt 4.5.

QColorDialog::QColorDialog ( const QColor & initial, QWidget * parent = 0 )

Construit une boîte de dialogue des couleurs avec le parent fourni et la couleur initiale spécifiée par initial.

Cette fonction a été introduite dans Qt 4.5.

QColorDialog::~QColorDialog ()

Détruit la boîte de dialogue des couleurs.

void QColorDialog::changeEvent ( QEvent * e ) [virtual protected]

Réimplémentation de QWidget::changeEvent().

void QColorDialog::colorSelected ( const QColor & color ) [signal]

Ce signal est émis juste après que l'utilisateur a cliqué sur OK pour sélectionner une couleur à utiliser. La couleur choisie est spécifiée par color.

Voir aussi color et currentColorChanged().

void QColorDialog::currentColorChanged ( const QColor & color ) [signal]

Ce signal est émis dès que la couleur courante change dans la boîte de dialogue. La couleur choisie est spécifiée par color. Voir aussi color et colorSelected().

QRgb QColorDialog::customColor ( int index ) [static]

Retourne la couleur personnalisée à l'index donné par index sous la forme d'une valeur QRgb. Cette fonction a été introduite dans Qt 4.5.

Voir aussi setCustomColor().

int QColorDialog::customCount () [static]

Retourne le nombre de couleurs personnalisées supportées par QColorDialog. Toutes les boîtes de dialogue des couleurs partagent les mêmes couleurs personnalisées.

void QColorDialog::done ( int result ) [virtual protected]

Réimplémentation de QDialog::done().

Ferme la boîte de dialogue et met son code de résultat dans result. Si cette boîte de dialogue est affichée avec exec(), done() implique que la boucle d'événement se termine et que exec() retourne result.

Voir aussi QDialog::done().

QColor QColorDialog::getColor ( const QColor & initial, QWidget * parent, const QString & title, ColorDialogOptions options = 0 ) [static]

Affiche une boîte de dialogue des couleurs modale avec le titre de fenêtre indiqué par title (égal à « Select Color » si aucun titre n'est spécifié), laisse l'utilisateur choisir une couleur et retourne cette dernière. La couleur est initialement fixée à initial. La boîte de dialogue est un enfant de parent. Elle retourne une couleur invalide ( voir QColor::isValid()) si l'utilisateur annule la boîte de dialogue.

L'argument options vous permet de personnaliser la boîte de dialogue.

Sur Symbian, cette fonction statique utilisera la boîte de dialogue des couleurs native et non pas un QColorDialog. Sur Symbian, les paramètres title et parent n'ont aucune pertinence et le paramètre options est uniquement utilisé pour définir si la boîte de dialogue des couleur native est utilisée ou non.

Cette fonction a été introduite dans Qt 4.5.

QColor QColorDialog::getColor ( const QColor & initial = Qt::white, QWidget * parent = 0 ) [static]

Affiche une boîte de dialogue des couleurs modale, laisse l'utilisateur choisir une couleur et retourne cette dernière. La couleur est initialement fixée à initial. La boîte de dialogue est un enfant de parent. Elle retourne une couleur invalide (voir QColor::isValid()) si l'utilisateur annule la boîte de dialogue.

Sur Symbian, cette fonction statique utilisera la boîte de dialogue des couleurs native et non pas un QColorDialog.

void QColorDialog::open ()

Affiche la boîte de dialogue en tant que Boîte de dialogue modale, et retourne immédiatement.

Cette fonction a été introduite dans Qt 4.5.

Voir aussi QDialog::open().

void QColorDialog::open ( QObject * receiver, const char * member )

Il s'agit d'une fonction surchargée.

Ouvre la boîte de dialogue et connecte son signal colorSelected() au slot spécifié par receiver et member.

Le signal sera déconnecté du slot quand la boîte de dialogue sera fermée.

Cette fonction a été introduite dans Qt 4.5.

QColor QColorDialog::selectedColor () const

Retourne la couleur que l'utilisateur a sélectionnée en cliquant sur le bouton OK ou un bouton équivalent.

Note. Cette couleur n'est pas toujours la même que la couleur indiquée par la propriété currentColor puisque l'utilisateur peut choisir différentes couleurs avant de finalement sélectionner celle à utiliser.

void QColorDialog::setCustomColor ( int index, QRgb color ) [static]

Fixe la couleur personnalisée à l'index index à la valeur QRgb color.

Note. Cette fonction ne s'applique pas à la boîte de dialogue des couleurs native sur la plateforme Mac OS X. Si vous avez vraiment besoin de cette fonction, utilisez l'option QColorDialog:: DontUseNativeDialog.

Voir aussi customColor().

void QColorDialog::setOption ( ColorDialogOption option, bool on = true )

Si le paramètre on est égal à true, active l› option donnée; sinon, désactive l'option.

Voir aussi options et testOption().

void QColorDialog::setStandardColor ( int index, QRgb color ) [static]

Fixe la couleur standard à l'index index à la valeur QRgb color.

Note. Cette fonction ne s'applique pas à la boîte de dialogue des couleurs native sur la plateforme Mac OS X. Si vous avez vraiment besoin de cette fonction, utilisez l'option QColorDialog:: DontUseNativeDialog.

void QColorDialog::setVisible ( bool visible ) [virtual]

Réimplémentation de QWidget::setVisible().

Change la visibilité de la boîte de dialogue. Si visible est égal à true, la boîte de dialogue est affichée; sinon, elle est cachée.

bool QColorDialog::testOption ( ColorDialogOption option ) const

Retourne true si l› option donnée est activée; sinon retourne false.

Cette fonction a été introduite dans Qt 4.5.

Voir aussi options et setOption().

Remerciements

Merci à Dimitry Ernot pour la traduction, ainsi qu'à Lo?c Leguay et Claude Leloup pour la relecture !