CheckButton

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

可检查的按钮。另请参阅CheckBox

描述

CheckButton是一个切换按钮,显示为一个可选字段。它在功能上类似于CheckBox,但外观不同。为了遵循用户体验,建议在切换它对某些东西有直接影响时使用CheckButton。例如,如果切换它可以启用或禁用设置而不需要用户按下确认按钮时,使用它。

参阅BaseButton,它包含了与该节点相关的常规属性和方法。

属性

TextAlign

align

0 (overrides Button)

bool

toggle_mode

true (overrides BaseButton)

主题属性

Color

font_color

Color( 0.88, 0.88, 0.88, 1 )

Color

font_color_disabled

Color( 0.9, 0.9, 0.9, 0.2 )

Color

font_color_focus

Color( 0.94, 0.94, 0.94, 1 )

Color

font_color_hover

Color( 0.94, 0.94, 0.94, 1 )

Color

font_color_hover_pressed

Color( 1, 1, 1, 1 )

Color

font_color_pressed

Color( 1, 1, 1, 1 )

int

check_vadjust

0

int

hseparation

4

Font

font

Texture

off

Texture

off_disabled

Texture

on

Texture

on_disabled

StyleBox

disabled

StyleBox

focus

StyleBox

hover

StyleBox

hover_pressed

StyleBox

normal

StyleBox

pressed

Theme Property Descriptions

Default

Color( 0.88, 0.88, 0.88, 1 )

CheckButton文本的字体颜色。


  • Color font_color_disabled

Default

Color( 0.9, 0.9, 0.9, 0.2 )

CheckButton文本在禁用时的字体颜色。


Default

Color( 0.94, 0.94, 0.94, 1 )

CheckButton 文本获得焦点时的字体颜色。仅替换按钮的正常文本颜色。禁用、悬停和按下状态优先于此颜色。


Default

Color( 0.94, 0.94, 0.94, 1 )

悬停时CheckButton文本的字体颜色。


  • Color font_color_hover_pressed

Default

Color( 1, 1, 1, 1 )

CheckButton被悬停和按下时,其文本的字体颜色。


  • Color font_color_pressed

Default

Color( 1, 1, 1, 1 )

按下CheckButton时文本的字体颜色。


  • int check_vadjust

Default

0

渲染切换图标时使用的垂直偏移量(以像素为单位)。


  • int hseparation

Default

4

切换图标和文本之间的分隔(以像素为单位)。


用于CheckButton文本的Font


未选中CheckButton时显示的图标。


未选中和禁用CheckButton时显示的图标。


选中CheckButton时显示的图标。


选中并禁用CheckButton时显示的图标。


CheckButton被禁用时,作为背景显示的StyleBox


CheckButton被聚焦时作为背景显示的StyleBox


CheckButton被悬停时作为背景显示的StyleBox


CheckButton被悬停和按下时作为背景显示的StyleBox


StyleBox显示为背景。


CheckButton被按下时作为背景显示的StyleBox