QColorDialog Class Reference - 《PyQt4 中文文档》

[ QtGui module]
Detailed Description
Type Documentation
Method Documentation
Qt Signal Documentation

[QtGui module]

该QColorDialog类提供了一个对话框控件指定颜色。More…

继承QDialog。

Types

enum ColorDialogOption { ShowAlphaChannel, NoButtons, DontUseNativeDialog }
class **[ColorDialogOptions](docs_index.htm)**

Methods

__init__ (self, QWidget parent = None)
__init__ (self, QColor initial, QWidget parent = None)
changeEvent (self, QEvent e)
QColor currentColor (self)
done (self, int result)
open (self)
open (self, QObject receiver, SLOT()SLOT() member)
open (self, callable receiver)
ColorDialogOptions options (self)
QColor selectedColor (self)
setCurrentColor (self, QColor color)
setOption (self, ColorDialogOption option, bool on = True)
setOptions (self, ColorDialogOptions options)
setVisible (self, bool visible)
bool testOption (self, ColorDialogOption option)

Static Methods

int customColor (int)
int customCount ()
QColor getColor (QColor initial = Qt.white, QWidget parent = None)
QColor getColor (QColor initial, QWidget parent, QString title, ColorDialogOptions options = 0)
(int, bool ok) getRgba (int initial = 4294967295, QWidget parent = None)
setCustomColor (int, int)
setStandardColor (int, int)

Qt Signals

void colorSelected (const QColor&)
void currentColorChanged (const QColor&)

Detailed Description

该QColorDialog类提供了一个对话框控件指定颜色。

颜色对话框的功能是让用户选择的颜色。例如，您可以使用这一个绘图程序，以允许用户设置画笔的颜色。

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

静getColor（）函数显示对话框，并且允许用户指定颜色。此功能也可以用来让用户选择一种颜色与透明度级别：通过ShowAlphaChannel选项作为附加参数。

用户可以存储customCount（）不同的自定义颜色。自定义颜色是由所有的颜色对话框共享，程序的执行过程中记住。使用setCustomColor（）来设置自定义颜色，并使用customColor（）来获取它们。

该Standard Dialogs示例显示了如何使用QColorDialog以及其他内置Qt对话框。

QColorDialog Class Reference - 图1

Type Documentation

QColorDialog.ColorDialogOption

此枚举指定了影响颜色对话框的外观和感觉的各种选项。

Constant	Value	Description
`QColorDialog.ShowAlphaChannel`	`0x00000001`	允许用户选择一种颜色的alpha分量。
`QColorDialog.NoButtons`	`0x00000002`	不显示OK和Cancel按钮。（有用的“现场对话” 。）
`QColorDialog.DontUseNativeDialog`	`0x00000004`	使用Qt的Mac上的标准颜色对话框，而不是苹果的原生颜色面板。

这个枚举被引入或修改的Qt 4.5 。

该ColorDialogOptions类型是一个typedef为QFlags\u003cColorDialogOption\u003e 。它存储ColorDialogOption值的或组合。

See also options，setOption（）testOption（）和windowModality（）。

Method Documentation

QColorDialog.__init__ (self, QWidget parent = None)

该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。

构造一个颜色对话框与给定parent。

此功能被引入Qt的4.5 。

QColorDialog.__init__ (self, QColor initial, QWidget parent = None)

该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。

构造一个颜色对话框与给定parent并指定initial颜色。

此功能被引入Qt的4.5 。

QColorDialog.changeEvent (self, QEvent e)

从重新实现QWidget.changeEvent（）。

QColor QColorDialog.currentColor (self)

[

int QColorDialog.customColor (int)

](docs_qcolor.html)

返回自定义颜色在给定的index作为 QRgb值。

此功能被引入Qt的4.5 。

See also setCustomColor（）。

int QColorDialog.customCount ()

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

QColorDialog.done (self, int result)

从重新实现QDialog.done（）。

关闭对话框，并将其结果代码result。如果显示此对话框exec（），（）完成将导致本地事件循环来完成，并exec（）返回result。

See also QDialog.done（）。

QColor QColorDialog.getColor (QColor initial = Qt.white, QWidget parent = None)

弹出的窗口给出一个模式对话框的颜色title（或“选择颜色” ，如果没有指定），让用户选择一种颜色，并返回该颜色。彩色初始设定为initial。对话框是一个孩子parent。它返回一个无效的（见 QColor.isValid（））如果用户取消该对话框的颜色。

该options参数允许您自定义对话框。

在Symbian ，这个静态函数将使用原生颜色对话框，而不是一个QColorDialog。在Symbian的参数title和parent有没有相关性和options参数仅用于定义是否被使用或不是天然颜色对话框。

此功能被引入Qt的4.5 。

QColor QColorDialog.getColor (QColor initial, QWidget parent, QString title, ColorDialogOptions options = 0)

弹出一个模态对话框颜色，让用户选择一种颜色，并返回该颜色。彩色初始设定为initial。对话框是一个孩子parent。它返回一个无效的（见 QColor.isValid（））如果用户取消该对话框的颜色。

在Symbian ，这个静态函数将使用原生颜色对话框，而不是一个QColorDialog。

(int, bool ok) QColorDialog.getRgba (int initial = 4294967295, QWidget parent = None)

QColorDialog.open (self)

显示该对话框的window modal dialog，立即返回。

此功能被引入Qt的4.5 。

See also QDialog.open（）。

QColorDialog.open (self, QObject receiver, SLOT()SLOT() member)

这是一个重载函数。

在打开的对话框并连接其colorSelected（）信号到由指定的槽receiver和member。

该信号会从插槽中断开时，关闭对话框。

此功能被引入Qt的4.5 。

QColorDialog.open (self, callable receiver)

ColorDialogOptions QColorDialog.options (self)

QColor QColorDialog.selectedColor (self)

[

返回用户选择通过单击颜色OK或等效按钮。

](docs_qcolor.html)

Note:这种颜色并非总是一样的保持的颜色 currentColor因为用户属性终于可以选择一个使用之前选择不同的颜色。

QColorDialog.setCurrentColor (self, QColor color)

QColorDialog.setCustomColor (int, int)

设置在自定义颜色index到QRgb color值。

Note:此功能并不适用于本机颜色对话框上的Mac OS X平台。如果您仍然需要使用此功能，请使用QColorDialog.DontUseNativeDialog选项。

See also customColor（）。

QColorDialog.setOption (self, ColorDialogOption option, bool on = True)

设置给定option被启用，如果on是真的，否则，清除给定的option。

See also options和testOption（）。

QColorDialog.setOptions (self, ColorDialogOptions options)

QColorDialog.setStandardColor (int, int)

设置标准色在index到QRgb color值。

Note:此功能并不适用于本机颜色对话框上的Mac OS X平台。如果您仍然需要使用此功能，请使用QColorDialog.DontUseNativeDialog选项。

QColorDialog.setVisible (self, bool visible)

从重新实现QWidget.setVisible（）。

更改对话框的可见性。如果visible为真，则显示的对话框，否则，它是隐藏的。

bool QColorDialog.testOption (self, ColorDialogOption option)

返回True如果给定的option被启用，否则返回False 。

此功能被引入Qt的4.5 。

See also options和setOption（）。

Qt Signal Documentation

void colorSelected (const QColor&)

这是该信号的默认超载。

这个信号被发射的用户点击后刚OK选择要使用的颜色。所选择的颜色是由指定的color。

See also color和currentColorChanged（）。

void currentColorChanged (const QColor&)

这是该信号的默认超载。

这个信号被发射时的对话在当前的颜色变化。当前颜色被指定color。

See also color和colorSelected（）。