TQColorDialog Class

Home | All Classes | Main Classes | Annotated | Grouped Classes | Functions |

# TQColorDialog Class Reference

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

`#include <ntqcolordialog.h>`

Inherits TQDialog.

List of all member functions.

## Static Public Members

- TQColor getColor ( const TQColor & initial = white, TQWidget * parent = 0, const char * name = 0 )
- TQRgb getRgba ( TQRgb initial, bool * ok = 0, TQWidget * parent = 0, const char * name = 0 )
- int customCount ()
- TQRgb customColor ( int i )
- void setCustomColor ( int i, TQRgb c )
- void setStandardColor ( int i, TQRgb c )

## Detailed Description

The TQColorDialog 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

### TQRgb TQColorDialog::customColor ( int i )`[static]`

Returns custom color number i as a TQRgb.

### int TQColorDialog::customCount ()`[static]`

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

### TQColor TQColorDialog::getColor ( const TQColor & initial = white, TQWidget * 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 TQColor::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.

### TQRgb TQColorDialog::getRgba ( TQRgb initial, bool * ok = 0, TQWidget * 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 TQColorDialog::setCustomColor ( int i, TQRgb c )`[static]`

Sets custom color number i to the TQRgb value c.

### void TQColorDialog::setStandardColor ( int i, TQRgb c )`[static]`

Sets standard color number i to the TQRgb value c.

This file is part of the TQt toolkit. Copyright © 1995-2007 Trolltech. All Rights Reserved.