XCEngine/docs/api/XCEngine/Editor/UI/ContextMenu/ContextMenu.md

ContextMenu

命名空间: XCEngine::Editor::UI

类型: utility-header

源文件: editor/src/UI/ContextMenu.h

描述: 为 Editor 统一封装上下文菜单 popup 的样式压栈、开启/结束入口和子菜单绘制辅助。

概述

ContextMenu.h 把 Dear ImGui 原始 popup API 收束成了 Editor 统一风格的上下文菜单入口。

当前公开入口

• BeginContextMenu(...)
• BeginContextMenuForLastItem(...)
• BeginContextMenuForWindow(...)
• EndContextMenu()
• DrawContextSubmenu(...)

当前行为

• 进入菜单前会统一压入 popup chrome 和 context menu layout style。
• 结束菜单时会对应弹出这些样式。
• DrawContextSubmenu(...) 会在打开子菜单时再压入 popup content chrome。

当前还有一条很具体的产品行为：

• 当子菜单 label 为 Create 时，会通过 Debug::Logger 追踪其打开/关闭状态。

当前使用位置

• HierarchyActionRouter.h
• ProjectPanel.cpp
• ConsolePanel.cpp
• InspectorPanel.cpp

当前实现边界

• 这里统一的是 Editor 菜单风格，不是通用 menu framework。
• 依赖当前 StyleTokens 和 Core.h 里定义的 popup chrome helper。

相关文档

• 当前模块
• MenuCommand
• Widgets