| Classes - Annotated - Tree - Functions - Home - Structure

# 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 ( QColor, QWidget * parent=0, const char * name=0 )
- QRgb getRgba ( QRgb, bool * ok = 0, QWidget * parent=0, const char * name=0 )
- int customCount ()
- QRgb customColor ( int )
- void setCustomColor ( int, QRgb )

## 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 instance, you might use this in a drawing program to allow the user to set the brush color.

This version of Qt only provides modal color dialogs. The static getColor() function shows the dialog and allows the user to specify a color, while getRgba() does the same but 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 customColor() to get them.

## 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 ( QColor initial, QWidget * parent=0, const char * name=0 ) `[static]`

Pops up a modal color dialog letting the user choose a color and returns that color. The color is initially set to initial. Returns an invalid color if the user cancels the dialog. All colors allocated by the dialog will be deallocated before this function returns.

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

Pops up a modal color dialog, letting the user choose a color and an alpha channel value. The color+alpha is initially set to initial.

If ok is non-null, `*ok` is set to TRUE if the user clicked OK, and 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.

Search the documentation, FAQ, qt-interest archive and more (uses www.trolltech.com):

This file is part of the Qt toolkit, copyright © 1995-2001 Trolltech, all rights reserved.