· Page d'accueil · Toutes les classes · Classes principales · Annotées · Classes groupées · Fonctions ·

QColorDialog Class Reference

The QColorDialog class provides a dialog widget for specifying colors. More...

#include <qcolordialog.h>

Inherits QDialog.

List of all member functions.

Static Public Members

QColor getColor ( const QColor & initial = white, QWidget * parent = 0, const char * name = 0 )
QRgb getRgba ( QRgb initial, bool * ok = 0, QWidget * parent = 0, const char * name = 0 )
int customCount ()
QRgb customColor ( int i )
void setCustomColor ( int i, QRgb c )
void setStandardColor ( int i, QRgb c )

Detailed Description

The QColorDialog class provides a dialog widget for specifying colors.

The color dialog's function is to allow users to choose colors. For example, you might use this in a drawing program to allow the user to set the brush color.

The static functions provide modal color dialogs.

The static getColor() function shows the dialog and allows the user to specify a color. The getRgba() function does the same but also allows the user to specify a color with an alpha channel (transparency) value.

The user can store customCount() different custom colors. The custom colors are shared by all color dialogs, and remembered during the execution of the program. Use setCustomColor() to set the custom colors, and use customColor() to get them.

See also Dialog Classes and Graphics Classes.

Member Function Documentation

QRgb QColorDialog::customColor ( int i ) `[static]`

Returns custom color number i as a QRgb.

int QColorDialog::customCount () `[static]`

Returns the number of custom colors supported by QColorDialog. All color dialogs share the same custom colors.

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

Pops up a modal color dialog, lets the user choose a color, and returns that color. The color is initially set to initial. The dialog is a child of parent and is called name. It returns an invalid (see QColor::isValid()) color if the user cancels the dialog. All colors allocated by the dialog will be deallocated before this function returns.

Examples: chart/setdataform.cpp and scribble/scribble.cpp.

QRgb QColorDialog::getRgba ( QRgb initial, bool * ok = 0, QWidget * parent = 0, const char * name = 0 ) `[static]`

Pops up a modal color dialog to allow the user to choose a color and an alpha channel (transparency) value. The color+alpha is initially set to initial. The dialog is a child of parent and called name.

If ok is non-null, *ok is set to TRUE if the user clicked OK, and to FALSE if the user clicked Cancel.

If the user clicks Cancel, the initial value is returned.

void QColorDialog::setCustomColor ( int i, QRgb c ) `[static]`

Sets custom color number i to the QRgb value c.

void QColorDialog::setStandardColor ( int i, QRgb c ) `[static]`

Sets standard color number i to the QRgb value c.

Best Of

Actualités les plus lues

Semaine

Mois

Année

Le Qt Labs au hasard

Utiliser OpenCL avec Qt

Les Qt Labs sont les laboratoires des développeurs de Qt, où ils peuvent partager des impressions sur le framework, son utilisation, ce que pourrait être son futur. Lire l'article.

Communauté

Ressources

Liens utiles

Contact

Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).

Qt dans le magazine

Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia.	Qt 3.2
Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !