UI 层级根节点更多...

#include <UICanvas.h>

类 UICanvas 继承关系图:

Public 成员函数
	UICanvas ()=default
	~UICanvas () override=default
SDL_FRect	getScreenRect () const
	Canvas 屏幕矩形（默认 = 渲染器逻辑分辨率）
int	getSortOrder () const
void	setSortOrder (int sortOrder)
Public 成员函数继承自 Component
	Component ()
virtual	~Component ()=default
virtual void	onCreate ()
virtual void	onAttach ()
virtual void	onDetach ()
virtual void	onDestroy ()
virtual void	onAfterDeserialize ()
	反序列化完成后回调（Prefab::apply 逐组件调用一次，字段已写入）。用于重建"直写字段绕过了 setter、无法自动触发的引擎状态"（如精灵纹理加载）。
virtual void	onFieldChanged (const std::string &fieldName)
	检查器直接写反射字段后回调（字段名）。用于绕过 setter 的直写完成后重新同步引擎状态（如 Box2D 刚体/形状）。默认无操作。
	Component (const Component &)=delete
Component &	operator= (const Component &)=delete
	Component (Component &&)=delete
Component &	operator= (Component &&)=delete
GameObject *	getOwner () const
bool	isRegistered () const
uint64_t	getUuid () const
	组件持久 ID（随 .scene 序列化，是 ComponentRef<T> 引用字段的寻址依据）
void	setUuid (uint64_t uuid)
	直接设置组件 ID（仅引擎反序列化/索引维护使用；正常流程由构造函数随机分配）

额外继承的成员函数
Protected 成员函数继承自 Component
void	setRegistered (bool registered)
Protected 属性继承自 Component
GameObject *	m_owner = nullptr
bool	m_isRegistered = false
uint64_t	m_uuid = 0
	持久 ID（构造时随机分配；0 仅在序列化前尚未赋值时短暂存在）

详细描述

UI 层级根节点

挂在有 UITransform 的 GameObject 上，使其成为 UI 层级树的根。子物体的 UITransform 若找不到父级 UITransform，会回退到此 Canvas 的屏幕矩形。

getScreenRect 默认返回渲染器逻辑分辨率矩形（ScreenSpaceOverlay 模式）。第一版不实现 Canvas Scaler，缩放依赖 SDL 的 logical presentation letterbox。

构造及析构函数说明

UICanvas ( )

default

~UICanvas ( )

overridedefault

SDL_FRect getScreenRect ( ) const

Canvas 屏幕矩形（默认 = 渲染器逻辑分辨率）

int getSortOrder ( ) const

inline

void setSortOrder ( int sortOrder )

inline

该类的文档由以下文件生成: