QColorDialog - Dialog widget for specifying colors
#include <qcolordialog.h>
Inherits QDialog.
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 )
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.
[Image Omitted]
[Image Omitted]
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
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.
SEE ALSO
http://doc.trolltech.com/qcolordialog.html
http://www.trolltech.com/faq/tech.html
COPYRIGHT
Copyright 1992-2001 Trolltech AS,
http://www.trolltech.com. See the license file included
in the distribution for a complete license statement.
AUTHOR
Generated automatically from the source code.
BUGS
If you find a bug in Qt, please report it as described in
http://doc.trolltech.com/bughowto.html. Good bug reports
make our job much simpler. Thank you.
In case of content or formattting problems with this
manual page, please report them to qt-bugs@trolltech.com.
Please include the name of the manual page
(qcolordialog.3qt) and the Qt version (2.3.1).
Man(1) output converted with
man2html