QColorDialog类

Qt 3.0.5

主页 | 所有的类 | 主要的类 | 注释的类 | 分组的类 | 函数

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 )
  • 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.cppscribble/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。保留所有权利。


Copyright © 2002 Trolltech Trademarks 译者:Cavendish
Qt 3.0.5版