QColorDialog类

QColorDialog类

QColorDialog类提供了指定颜色的对话框窗口部件。 详情请见……

#include <qcolordialog.h>

继承了QDialog。

所有成员函数的列表。

静态公有成员

• 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 )

---

详细描述

QColorDialog类提供了指定颜色的对话框窗口部件。

眼色对话框函数允许用户来选择颜色——例如，你也许在一个绘制程序中使用它来允许用户设置画刷颜色。

静态函数提供模式颜色对话框。

getColor()静态函数显示对话框并且允许用户指定一个颜色。getRgba()函数可以做同样的事情但是也允许用户指定一个有alpha通道（透明）值的颜色。

用户可以用customCount()来存储不同的自定义颜色。自定义颜色被所有颜色对话框共享，并且在这个程序执行期间被记住。使用setCustomColor()来设置自定义颜色，并且使用customColor()来得到它们。

也可以参考对话框类和图形类。

---

成员函数文档

QRgb QColorDialog::customColor ( int i ) [静态]

返回一个数字为 i的QRgb自定义颜色。

int QColorDialog::customCount () [静态]

返回QColorDialog所支持的自定义颜色的数量。所有的颜色对话框共享相同的自定义颜色。

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

弹出模式颜色对话框，让用户选择一个颜色并且返回那个颜色。这个颜色用 initial来初始化。对话框是 parent的孩子并且名为 name。如果用户撤消这个对话框，返回一个无效的颜色（请参考 QColor::isValid()）。对话框分配的所有颜色在函数返回之前都将被释放。

实例：chart/setdataform.cpp和scribble/scribble.cpp。

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

弹出模式颜色对话框，让用户选择一个颜色和一个alpha通道（透明）值。这个颜色和alpha用 initial来初始化。对话框是 parent的孩子并且名为 name。

如果ok为非空，如果用户点击OK，*ok被设置为真，并且如果用户点击Cancel，就被设置为假。

如果用户点击Cancel，initial值被返回。

void QColorDialog::setCustomColor ( int i, QRgb c ) [静态]

设置数字为 i的自定义颜色为QRgb值 c。

---

这个文件是Qt工具包一部分。版权所有 © 1995-2002 Trolltech。保留所有权利。