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

CanvasGroup

节点继承关系

继承链：Node → CanvasItem → CanvasGroup

CanvasItem

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

Node

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

定义

CanvasGroup 是 CanvasItem 组，统一裁剪和排序。

使用频率：★★★ 一般常用。

节点用途

• 将多个 2D 可绘制节点作为一个整体进行裁剪、排序和渲染控制

常用节点搭配

搭配节点	搭配方式	用途
TODO	TODO	TODO

节点属性与信号

自有属性

属性	类型	默认值	继承自	说明
TODO	TODO	TODO	—	TODO

信号

信号	参数	说明
TODO	TODO	TODO

常用方法

方法	返回值	说明
TODO	TODO	TODO

代码示例

基础用法

C#

// TODO: CanvasGroup 基础用法示例

GDScript

# TODO: CanvasGroup 基础用法示例