<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
< html >
< head >
< meta http-equiv = "Content-Type" content = "text/html; charset=ISO-8859-1" >
< title > TQColorDialog Class< / title >
< style type = "text/css" > < ! - -
fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; }
-->< / style >
< / head >
< body >
< table border = "0" cellpadding = "0" cellspacing = "0" width = "100%" >
< tr bgcolor = "#E5E5E5" >
< td valign = center >
< a href = "index.html" >
< font color = "#004faf" > Home< / font > < / a >
| < a href = "classes.html" >
< font color = "#004faf" > All Classes< / font > < / a >
| < a href = "mainclasses.html" >
< font color = "#004faf" > Main Classes< / font > < / a >
| < a href = "annotated.html" >
< font color = "#004faf" > Annotated< / font > < / a >
| < a href = "groups.html" >
< font color = "#004faf" > Grouped Classes< / font > < / a >
| < a href = "functions.html" >
< font color = "#004faf" > Functions< / font > < / a >
< / td >
< td align = "right" valign = "center" > < img src = "logo32.png" align = "right" width = "64" height = "32" border = "0" > < / td > < / tr > < / table > < h1 align = center > TQColorDialog Class Reference< / h1 >
< p > The TQColorDialog class provides a dialog widget for specifying colors.
< a href = "#details" > More...< / a >
< p > < tt > #include < < a href = "tqcolordialog-h.html" > tqcolordialog.h< / a > > < / tt >
< p > Inherits < a href = "tqdialog.html" > TQDialog< / a > .
< p > < a href = "tqcolordialog-members.html" > List of all member functions.< / a >
< h2 > Static Public Members< / h2 >
< ul >
< li class = fn > TQColor < a href = "#getColor" > < b > getColor< / b > < / a > ( const TQColor & initial = white, TQWidget * parent = 0, const char * name = 0 )< / li >
< li class = fn > TQRgb < a href = "#getRgba" > < b > getRgba< / b > < / a > ( TQRgb initial, bool * ok = 0, TQWidget * parent = 0, const char * name = 0 )< / li >
< li class = fn > int < a href = "#customCount" > < b > customCount< / b > < / a > ()< / li >
< li class = fn > TQRgb < a href = "#customColor" > < b > customColor< / b > < / a > ( int i )< / li >
< li class = fn > void < a href = "#setCustomColor" > < b > setCustomColor< / b > < / a > ( int i, TQRgb c )< / li >
< li class = fn > void < a href = "#setStandardColor" > < b > setStandardColor< / b > < / a > ( int i, TQRgb c )< / li >
< / ul >
< hr > < a name = "details" > < / a > < h2 > Detailed Description< / h2 >
The TQColorDialog class provides a dialog widget for specifying colors.
< p > 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.
< p > The static functions provide modal color dialogs.
< p > The static < a href = "#getColor" > getColor< / a > () function shows the dialog and allows the
user to specify a color. The < a href = "#getRgba" > getRgba< / a > () function does the same but
also allows the user to specify a color with an alpha channel
(transparency) value.
< p > The user can store < a href = "#customCount" > customCount< / a > () different custom colors. The
custom colors are shared by all color dialogs, and remembered
during the execution of the program. Use < a href = "#setCustomColor" > setCustomColor< / a > () to set
the custom colors, and use < a href = "#customColor" > customColor< / a > () to get them.
< p > < center > < img src = "tqcolordlg-w.png" > < / center > < p > See also < a href = "dialogs.html" > Dialog Classes< / a > and < a href = "graphics.html" > Graphics Classes< / a > .
< hr > < h2 > Member Function Documentation< / h2 >
< h3 class = fn > TQRgb < a name = "customColor" > < / a > TQColorDialog::customColor ( int i )< tt > [static]< / tt >
< / h3 >
Returns custom color number < em > i< / em > as a TQRgb.
< h3 class = fn > int < a name = "customCount" > < / a > TQColorDialog::customCount ()< tt > [static]< / tt >
< / h3 >
Returns the number of custom colors supported by TQColorDialog. All
color dialogs share the same custom colors.
< h3 class = fn > < a href = "tqcolor.html" > TQColor< / a > < a name = "getColor" > < / a > TQColorDialog::getColor ( const < a href = "tqcolor.html" > TQColor< / a > & initial = white, < a href = "tqwidget.html" > TQWidget< / a > * parent = 0, const char * name = 0 )< tt > [static]< / tt >
< / h3 >
Pops up a modal color dialog, lets the user choose a color, and
returns that color. The color is initially set to < em > initial< / em > . The
dialog is a child of < em > parent< / em > and is called < em > name< / em > . It returns
an invalid (see < a href = "tqcolor.html#isValid" > TQColor::isValid< / a > ()) color if the user cancels the
dialog. All colors allocated by the dialog will be deallocated
before this function returns.
< p > Examples: < a href = "tutorial2-08.html#x2601" > chart/setdataform.cpp< / a > and < a href = "scribble-example.html#x909" > scribble/scribble.cpp< / a > .
< h3 class = fn > TQRgb < a name = "getRgba" > < / a > TQColorDialog::getRgba ( TQRgb initial, bool * ok = 0, < a href = "tqwidget.html" > TQWidget< / a > * parent = 0, const char * name = 0 )< tt > [static]< / tt >
< / h3 >
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 < em > initial< / em > . The dialog is a child of < em > parent< / em >
and called < em > name< / em > .
< p > If < em > ok< / em > is non-null, < em > *< / em > < em > ok< / em > is set to TRUE if the user clicked
OK, and to FALSE if the user clicked Cancel.
< p > If the user clicks Cancel, the < em > initial< / em > value is returned.
< h3 class = fn > void < a name = "setCustomColor" > < / a > TQColorDialog::setCustomColor ( int i, TQRgb c )< tt > [static]< / tt >
< / h3 >
Sets custom color number < em > i< / em > to the TQRgb value < em > c< / em > .
< h3 class = fn > void < a name = "setStandardColor" > < / a > TQColorDialog::setStandardColor ( int i, TQRgb c )< tt > [static]< / tt >
< / h3 >
Sets standard color number < em > i< / em > to the TQRgb value < em > c< / em > .
<!-- eof -->
< hr > < p >
This file is part of the < a href = "index.html" > TQt toolkit< / a > .
Copyright © 1995-2007
< a href = "http://www.trolltech.com/" > Trolltech< / a > . All Rights Reserved.< p > < address > < hr > < div align = center >
< table width = 100% cellspacing = 0 border = 0 > < tr >
< td > Copyright © 2007
< a href = "troll.html" > Trolltech< / a > < td align = center > < a href = "trademarks.html" > Trademarks< / a >
< td align = right > < div align = right > TQt 3.3.8< / div >
< / table > < / div > < / address > < / body >
< / html >
