PySide6.QtWidgets.QColorDialog

class QColorDialog

QColorDialog 类提供了一个用于指定颜色的对话框部件。更多…

PySide6.QtWidgets.QColorDialog 的继承图

概要

属性

方法

信号

静态函数

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述

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

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

静态函数 getColor() 显示对话框，并允许用户指定颜色。此函数还可用于让用户选择具有透明度的颜色：将 ShowAlphaChannel 选项作为附加参数传递。

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

当按下“选择屏幕颜色”按钮时，光标会变成一个十字形，并扫描屏幕上的颜色。用户可以通过点击鼠标或按下Enter键来选择一个颜色。按下Escape键会恢复进入此模式前最后选择的颜色。

标准对话框示例展示了如何使用QColorDialog以及其他内置的Qt对话框。

../../_images/fusion-colordialog.png

另请参阅

QFileDialog QFontDialog 标准对话框示例

class ColorDialogOption

(继承自 enum.Flag) 此枚举指定了影响颜色对话框外观和感觉的各种选项。

常量

描述

QColorDialog.ShowAlphaChannel

允许用户选择颜色的透明度组件。

QColorDialog.NoButtons

不显示确定和取消按钮。（适用于“实时对话框”。）

QColorDialog.NoEyeDropperButton

隐藏吸管按钮。此值在Qt 6.6中添加。

QColorDialog.DontUseNativeDialog

使用Qt的标准颜色对话框，而不是操作系统的原生颜色对话框。

另请参阅

options setOption() testOption() windowModality()

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property currentColorᅟ: QColor

此属性保存对话框中当前选定的颜色。

Access functions:
property optionsᅟ: Combination of QColorDialog.ColorDialogOption

此属性包含影响对话框外观和感觉的各种选项。

默认情况下，所有选项都被禁用。

选项应在显示对话框之前设置。在对话框可见时设置它们，不能保证立即对对话框产生影响（取决于选项和平台）。

另请参阅

setOption() testOption()

Access functions:
__init__([parent=None])
Parameters:

父级 – QWidget

使用给定的parent构建一个颜色对话框。

__init__(initial[, parent=None])
Parameters:

使用给定的parent和指定的initial颜色构建一个颜色对话框。

colorSelected(color)
Parameters:

颜色 – QColor

当用户点击确定选择要使用的颜色后，会发出此信号。所选颜色由color指定。

currentColor()
Return type:

QColor

另请参阅

setCurrentColor()

属性 currentColorᅟ 的获取器。

currentColorChanged(color)
Parameters:

颜色 – QColor

每当对话框中的当前颜色发生变化时，都会发出此信号。当前颜色由color指定。

另请参阅

颜色 colorSelected()

属性 currentColorᅟ 的通知信号。

static customColor(index)
Parameters:

索引 – int

Return type:

QColor

返回给定index处的自定义颜色作为QColor值。

另请参阅

setCustomColor()

static customCount()
Return type:

整数

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

static getColor([initial=Qt.white[, parent=None[, title=""[, options=QColorDialog.ColorDialogOptions()]]]])
Parameters:
Return type:

QColor

弹出一个带有给定窗口title（如果未指定，则为“选择颜色”）的模态颜色对话框，让用户选择颜色，并返回该颜色。颜色最初设置为initial。对话框是parent的子窗口。如果用户取消对话框，则返回无效颜色（参见QColor::isValid()）。

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

open(receiver, member)
Parameters:

  • receiver – QObject

  • member – str

打开对话框并将其colorSelected()信号连接到由receiver和member指定的槽。

当对话框关闭时，信号将从插槽断开。

options()
Return type:

ColorDialogOption 的组合

另请参阅

setOptions()

属性 optionsᅟ 的获取器。

selectedColor()
Return type:

QColor

返回用户通过点击确定或等效按钮选择的颜色。

注意

这个颜色并不总是与currentColor属性所持有的颜色相同，因为用户可以在最终选择使用之前选择不同的颜色。

setCurrentColor(color)
Parameters:

颜色 – QColor

另请参阅

currentColor()

属性 currentColorᅟ 的设置器。

static setCustomColor(index, color)
Parameters:

  • index – 整数

  • 颜色 – QColor

将自定义颜色在index处设置为QColor color值。

注意

此功能不适用于macOS平台上的原生颜色对话框。如果您仍然需要此功能，请使用DontUseNativeDialog选项。

另请参阅

customColor()

setOption(option[, on=true])
Parameters:

如果on为真，则启用给定的option；否则，清除给定的option。

另请参阅

options testOption()

setOptions(options)
Parameters:

options – ColorDialogOption 的组合

另请参阅

options()

属性 optionsᅟ 的设置器。

static setStandardColor(index, color)
Parameters:

  • index – 整数

  • 颜色 – QColor

将标准颜色设置为index处的QColor color值。

注意

此功能不适用于macOS平台上的原生颜色对话框。如果您仍然需要此功能，请使用DontUseNativeDialog选项。

另请参阅

standardColor()

static standardColor(index)
Parameters:

索引 – int

Return type:

QColor

返回给定index处的标准颜色作为QColor值。

另请参阅

setStandardColor()

testOption(option)
Parameters:

选项 – ColorDialogOption

Return type:

布尔

如果给定的option已启用，则返回true；否则，返回false。

另请参阅

options setOption()