Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

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 ( Color value )

  • Color get_pick_color ( )

当前选择的颜色。


bool edit_alpha = true

  • void set_edit_alpha ( bool value )

  • bool is_editing_alpha ( )

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


方法说明

ColorPicker get_picker ( )

返回此节点所切换的 ColorPicker

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


PopupPanel get_popup ( )

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

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


主题属性说明

Texture2D bg

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