ColorPickerButton

Inherits: Button < BaseButton < Control < CanvasItem < Node < Object

弹出ColorPicker的按钮。

描述

将ColorPicker封装成可以通过按一个按钮来进行使用。点击按钮可以切换出可见的ColorPicker。

另请参阅BaseButton。它包括了和这个节点共同拥有的属性和方法。

注意：按钮默认状态时可能非常窄，导致颜色预览样本不可见。确保将Control.rect_min_size设置的足够大从而给这个按钮足够的空间去显示。

教程

• GUI Drag And Drop Demo

• 2D GD Paint Demo

属性

方法

主题属性

信号

• color_changed ( Color color )

颜色改变时发出。

• picker_created ( )

创建ColorPicker时（第一次按下按钮）发出。

• popup_closed ( )

当ColorPicker关闭时发出。

属性说明

• Color color

当前选择的颜色。

• bool edit_alpha

如果true，则显示的ColorPicker中的alpha通道将可见。

方法说明

• ColorPicker get_picker ( )

返回此节点所切换的 ColorPicker。

警告： 这是一个必需的内部节点，移除和释放它可能会导致崩溃。如果你希望隐藏它或其所有子项，请使用其 CanvasItem.visible 属性。

• PopupPanel get_popup ( )

返回控件的 PopupPanel，它允许你连接到弹出信号。这允许你在显示或隐藏 ColorPicker 时事件处理。

警告： 这是一个必需的内部节点，删除和释放它可能会导致崩溃。如果你希望隐藏它或其任何子项，请使用其 CanvasItem.visible 属性。

Theme Property Descriptions

• Color font_color

ColorPickerButton的默认文本Color。

• Color font_color_disabled

禁用ColorPickerButton时使用的文本Color。

• Color font_color_focus

当ColorPickerButton获得焦点时使用的文本Color。只替换按钮的正常文本颜色。禁用、悬停和按下状态优先于这个颜色。

• Color font_color_hover

悬停ColorPickerButton时使用的文本Color。

• Color font_color_pressed

按下ColorPickerButton时使用的文本Color。

• int hseparation

ColorPickerButton的图标和文本之间的水平间距。

• Font font

ColorPickerButton文本的Font。

• Texture bg

颜色预览的背景将在按钮上显示。

• StyleBox disabled

当ColorPickerButton被禁用时使用的StyleBox。

• StyleBox focus

当ColorPickerButton获得焦点时使用的StyleBox。它显示在当前的StyleBox上，所以使用StyleBoxEmpty只是禁用焦点视觉效果。

• StyleBox hover

悬停ColorPickerButton时使用的StyleBox。

• StyleBox normal

ColorPickerButton的默认StyleBox。

• StyleBox pressed

按下ColorPickerButton时使用的StyleBox。