Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

ColorPickerButton

继承: Button < BaseButton < Control < CanvasItem < Node < Object

点击后会显示 ColorPicker 的按钮。

描述

封装一个 ColorPicker,按下按钮即可访问该控件。按下按钮会切换 ColorPicker 的可见性。

另见 BaseButton,其中包含与该节点关联的通用属性和方法。

注意:默认情况下,按钮的宽度可能不足以使颜色预览色板可见。确保将 Control.custom_minimum_size 设置为足够大的值,以便为按钮提供足够的空间。

教程

属性

Color

color

Color(0, 0, 0, 1)

bool

edit_alpha

true

bool

toggle_mode

true (overrides BaseButton)

方法

ColorPicker

get_picker()

PopupPanel

get_popup()

主题属性

Texture2D

bg


信号

color_changed(color: Color) 🔗

颜色改变时发出。


picker_created() 🔗

创建 ColorPicker 时(第一次按下按钮)发出。


popup_closed() 🔗

ColorPicker 关闭时发出。


属性说明

Color color = Color(0, 0, 0, 1) 🔗

  • void set_pick_color(value: Color)

  • Color get_pick_color()

当前选择的颜色。


bool edit_alpha = true 🔗

  • void set_edit_alpha(value: bool)

  • bool is_editing_alpha()

如果为 true,则显示的 ColorPicker 中的 Alpha 通道将可见。


方法说明

ColorPicker get_picker() 🔗

返回此节点所切换的 ColorPicker

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


PopupPanel get_popup() 🔗

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

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


主题属性说明

Texture2D bg 🔗

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