XCEngine/docs/api/XCEngine/Editor/Actions/HierarchyActionRouter/HierarchyActionRouter.md

HierarchyActionRouter

命名空间: XCEngine::Editor::Actions

类型: header-helper

源文件: editor/src/Actions/HierarchyActionRouter.h

描述: 封装 Hierarchy 面板中的选中、重命名、拖拽重挂接、排序和上下文菜单动作。

概述

HierarchyActionRouter 是当前实体层级树交互的主要承载者。它把 HierarchyPanel.cpp 中最容易膨胀的逻辑拆成了几类可复用动作：

• 选择与背景点击清空选择
• 实体重命名请求与提交
• 拖拽实体到其他父节点或根节点
• 创建 / 删除 / 复制 / 粘贴 / 重复实体
• 排序选项弹窗

当前实现

• 拖拽载荷类型固定为字符串 "ENTITY_PTR"
• HandleHierarchySelectionClick 只实现了单选和 Ctrl 增选
• CommitEntityRename 会先验证实体存在且名字非空，再调用 RenameEntity
• 拖拽重挂接时会调用 Commands::CanReparentEntity 和 ReparentEntityPreserveWorldTransform
• 背景右键菜单可以直接创建空物体、Camera、Light，以及命名为 Cube / Sphere / Plane 的空实体

设计说明

这类层级树交互通常非常碎，如果全写在面板类里，后续一加多选、拖放规则或菜单项就会迅速失控。
把交互逻辑集中在 router 里有三个好处：

• 面板类仍然只负责树结构遍历和 UI 布局
• 所有入口都能复用同一套实体命令
• 可以明确把“层级树交互规则”与“SceneManager 真正修改场景”的职责隔开

这和 Unity Hierarchy 的设计也比较接近：Hierarchy 面板只是入口，真正的数据修改要落到场景编辑命令层。

当前限制

• 暂不支持多实体批量拖拽
• 只有 Ctrl 增选，没有框选、Shift 范围选中等高级交互
• Cube / Sphere / Plane 当前只是命名约定，不会自动附加网格或渲染组件

相关文档

• Actions
• HierarchyPanel
• EntityCommands
• EditorEvents