ColorPickerButton¶
Inherits: Button < BaseButton < Control < CanvasItem < Node < Object
弹出ColorPicker的按钮。
描述¶
将ColorPicker封装成可以通过按一个按钮来进行使用。点击按钮可以切换出可见的ColorPicker。
另请参阅BaseButton。它包括了和这个节点共同拥有的属性和方法。
注意:按钮默认状态时可能非常窄,导致颜色预览样本不可见。确保将Control.rect_min_size设置的足够大从而给这个按钮足够的空间去显示。
教程¶
属性¶
|
||
|
||
toggle_mode |
|
方法¶
get_picker ( ) |
|
get_popup ( ) |
主题属性¶
|
||
|
||
|
||
|
||
|
||
|
||
信号¶
color_changed ( Color color )
颜色改变时发出。
picker_created ( )
创建ColorPicker时(第一次按下按钮)发出。
popup_closed ( )
当ColorPicker关闭时发出。
属性说明¶
Color color
Default |
|
Setter |
set_pick_color(value) |
Getter |
get_pick_color() |
当前选择的颜色。
bool edit_alpha
Default |
|
Setter |
set_edit_alpha(value) |
Getter |
is_editing_alpha() |
如果true
,则显示的ColorPicker中的alpha通道将可见。
方法说明¶
ColorPicker get_picker ( )
返回此节点所切换的 ColorPicker。
警告: 这是一个必需的内部节点,移除和释放它可能会导致崩溃。如果你希望隐藏它或其所有子项,请使用其 CanvasItem.visible 属性。
PopupPanel get_popup ( )
返回控件的 PopupPanel,它允许你连接到弹出信号。这允许你在显示或隐藏 ColorPicker 时事件处理。
警告: 这是一个必需的内部节点,删除和释放它可能会导致崩溃。如果你希望隐藏它或其任何子项,请使用其 CanvasItem.visible 属性。
Theme Property Descriptions¶
Color font_color
Default |
|
ColorPickerButton
的默认文本Color。
Color font_color_disabled
Default |
|
禁用ColorPickerButton
时使用的文本Color。
Color font_color_focus
Default |
|
当ColorPickerButton
获得焦点时使用的文本Color。只替换按钮的正常文本颜色。禁用、悬停和按下状态优先于这个颜色。
Color font_color_hover
Default |
|
悬停ColorPickerButton
时使用的文本Color。
Color font_color_pressed
Default |
|
按下ColorPickerButton
时使用的文本Color。
int hseparation
Default |
|
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。