最后同步日期：2026-04-15 | Godot 官方原文 — BaseButton

BaseButton

节点继承关系

继承链：Node → CanvasItem → Control → BaseButton

Control

类型	名称	说明
属性	Size	控件尺寸
属性	Position	控件位置
属性	AnchorsPreset	锚点预设
属性	GrowDirection	超出容器时的扩展方向
属性	MouseFilter	鼠标事件过滤（停止 / 通过 / 忽略）
属性	FocusMode	焦点模式（无 / 单击 / 全部）
信号	gui_input	接收到 GUI 输入事件
信号	mouse_entered	鼠标进入控件区域
信号	mouse_exited	鼠标离开控件区域
信号	focus_entered	获得焦点
信号	focus_exited	失去焦点
信号	resized	尺寸变化
方法	GrabFocus()	获取焦点
方法	ReleaseFocus()	释放焦点
方法	SetAnchorsPreset()	设置锚点预设
方法	GetMinimumSize()	获取最小尺寸

CanvasItem

类型	名称	说明
属性	Visible	是否可见
属性	Modulate	整体颜色叠加（乘法）
属性	SelfModulate	自身颜色叠加（不影响子节点）
属性	ZIndex	绘制层级（Z 轴排序）
信号	visibility_changed	可见性变化时触发
方法	GetGlobalMousePosition()	获取鼠标全局坐标

Node

类型	名称	说明
属性	Name	节点名称
属性	ProcessMode	处理模式（始终 / 暂停时 / 仅编辑器）
属性	ProcessPriority	处理优先级，数字越小越先执行
信号	ready	节点进入场景树并准备就绪
信号	tree_entered	节点进入场景树
信号	tree_exited	节点完全离开场景树
方法	GetNode<T>()	按路径获取子节点
方法	AddChild()	添加子节点
方法	RemoveChild()	移除子节点
方法	QueueFree()	帧结束后释放节点
方法	GetParent()	获取父节点

定义

BaseButton 是所有按钮的抽象基类。你不会直接使用 BaseButton 本身，而是使用它的子类——Button、TextureButton、CheckBox 等。它定义了所有按钮共有的能力和行为——比如可以被点击、可以被禁用、可以被切换。

使用频率：★★★★ 维度专用常用（所有按钮的基类，通过子类间接使用）

节点用途

• 作为所有按钮的基类，提供按钮公共能力
• 定义按钮的通用属性和信号

使用场景

• 不直接使用，请使用具体的子类

常用节点搭配

所有具体按钮都是它的子类：

• Button — 标准按钮
• TextureButton — 图片按钮
• LinkButton — 超链接按钮
• MenuButton — 下拉菜单按钮
• OptionButton — 下拉选择按钮
• CheckBox — 复选框
• CheckButton — 切换开关
• ColorPickerButton — 颜色选择按钮

生效必备素材/资源

无需特殊资源。

节点属性与信号

自有属性

属性	类型	默认值	继承自	说明
disabled	bool	false	—	是否禁用（变灰，不可点击）
button_pressed	bool	false	—	按钮是否处于按下/选中状态
toggle_mode	bool	false	—	是否为切换模式（点一下开、再点一下关）
action_mode	枚举	Press	—	按钮响应模式：Press（按下触发）、Release（松开触发）
button_group	ButtonGroup	null	—	按钮组（用于单选互斥）
shortcut	Shortcut	null	—	快捷键
shortcut_in_tooltip	bool	true	—	是否在提示中显示快捷键

信号

信号	触发时机	参数
pressed	按钮被点击（按下并松开）时	无
button_down	鼠标按下时（还没松开）	无
button_up	鼠标松开时	无
toggled	切换状态变化时（需开启 toggle_mode）	bool 是否按下

常用方法

方法	说明
SetDisabled(bool)	设置是否禁用
SetPressed(bool)	设置按下状态
SetToggleMode(bool)	设置是否为切换模式
IsHovered()	鼠标是否悬停在按钮上

代码示例

C

// BaseButton 是抽象基类，请使用具体子类
// 示例参考 Button、TextureButton、CheckBox 等页面

GDScript

# BaseButton 是抽象基类，请使用具体子类
# 示例参考 Button、TextureButton、CheckBox 等页面