PySide6.QtWidgets.QColorDialog¶
- class QColorDialog¶
QColorDialog
类提供了一个用于指定颜色的对话框部件。更多…概要¶
属性¶
currentColorᅟ
- 对话框中当前选择的颜色optionsᅟ
- 影响对话框外观和感觉的各种选项
方法¶
def
__init__()
def
currentColor()
def
open()
def
options()
def
selectedColor()
def
setOption()
def
setOptions()
def
testOption()
信号¶
def
colorSelected()
静态函数¶
def
customColor()
def
customCount()
def
getColor()
def
setCustomColor()
def
standardColor()
注意
本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题,您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。
详细描述¶
颜色对话框的功能是允许用户选择颜色。例如,您可以在绘图程序中使用此功能,以允许用户设置画笔颜色。
静态函数提供了模态颜色对话框。
静态函数
getColor()
显示对话框,并允许用户指定颜色。此函数还可用于让用户选择具有透明度的颜色:将ShowAlphaChannel
选项作为附加参数传递。用户可以存储
customCount()
种不同的自定义颜色。这些自定义颜色在所有颜色对话框中共享,并在程序执行期间被记住。使用setCustomColor()
来设置自定义颜色,并使用customColor()
来获取它们。当按下“选择屏幕颜色”按钮时,光标会变成一个十字形,并扫描屏幕上的颜色。用户可以通过点击鼠标或按下Enter键来选择一个颜色。按下Escape键会恢复进入此模式前最后选择的颜色。
标准对话框示例展示了如何使用
QColorDialog
以及其他内置的Qt对话框。另请参阅
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
时,属性可以直接使用,否则通过访问器函数使用。此属性保存对话框中当前选定的颜色。
- Access functions:
- property optionsᅟ: Combination of QColorDialog.ColorDialogOption¶
此属性包含影响对话框外观和感觉的各种选项。
默认情况下,所有选项都被禁用。
选项应在显示对话框之前设置。在对话框可见时设置它们,不能保证立即对对话框产生影响(取决于选项和平台)。
另请参阅
- Access functions:
使用给定的
parent
构建一个颜色对话框。使用给定的
parent
和指定的initial
颜色构建一个颜色对话框。当用户点击确定选择要使用的颜色后,会发出此信号。所选颜色由
color
指定。另请参阅
- currentColor()¶
- Return type:
另请参阅
属性
currentColorᅟ
的获取器。每当对话框中的当前颜色发生变化时,都会发出此信号。当前颜色由
color
指定。另请参阅
属性
currentColorᅟ
的通知信号。返回给定
index
处的自定义颜色作为QColor值。另请参阅
- static customCount()¶
- Return type:
整数
返回由
QColorDialog
支持的自定义颜色数量。所有颜色对话框共享相同的自定义颜色。- static getColor([initial=Qt.white[, parent=None[, title=""[, options=QColorDialog.ColorDialogOptions()]]]])¶
- Parameters:
initial –
QColor
parent –
QWidget
标题 – str
options –
ColorDialogOption
的组合
- Return type:
弹出一个带有给定窗口
title
(如果未指定,则为“选择颜色”)的模态颜色对话框,让用户选择颜色,并返回该颜色。颜色最初设置为initial
。对话框是parent
的子窗口。如果用户取消对话框,则返回无效颜色(参见QColor::isValid())。options
参数允许您自定义对话框。打开对话框并将其
colorSelected()
信号连接到由receiver
和member
指定的槽。当对话框关闭时,信号将从插槽断开。
- options()¶
- Return type:
另请参阅
属性
optionsᅟ
的获取器。返回用户通过点击确定或等效按钮选择的颜色。
注意
这个颜色并不总是与
currentColor
属性所持有的颜色相同,因为用户可以在最终选择使用之前选择不同的颜色。属性
currentColorᅟ
的设置器。将自定义颜色在
index
处设置为QColorcolor
值。- setOption(option[, on=true])¶
- Parameters:
option –
ColorDialogOption
on – 布尔值
如果
on
为真,则启用给定的option
;否则,清除给定的option
。另请参阅
- setOptions(options)¶
- Parameters:
options –
ColorDialogOption
的组合
另请参阅
属性
optionsᅟ
的设置器。将标准颜色设置为
index
处的QColorcolor
值。返回给定
index
处的标准颜色作为QColor值。另请参阅
- testOption(option)¶
- Parameters:
选项 –
ColorDialogOption
- Return type:
布尔
如果给定的
option
已启用,则返回true
;否则,返回false。另请参阅