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

ScalarControls

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

类型: header-helper

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

描述: 提供基于双列表格布局的标量属性控件，如 float、int、bool、颜色和下拉框。

概述

ScalarControls.h 封装的是 Inspector 最基础的输入部件：

• DrawFloat
• DrawInt
• DrawBool
• DrawColor3
• DrawColor4
• DrawSliderFloat
• DrawSliderInt
• DrawCombo

当前实现

• 所有控件都建立在 DrawControlRow 之上
• 默认列宽来自 DefaultControlLabelWidth()
• 每个控件都统一使用 ##value 作为内部 item id 后缀，并通过外层 PushID(label) 隔离

设计说明

这层的价值在于把“输入控件长什么样”从组件编辑器里抽出来。
否则每个组件 editor 都会重复写：

• 两列表格
• 标签列宽
• SetNextItemWidth
• 不同控件的 ImGui 参数模板

ScalarControls 让上层代码只保留业务字段名和少量范围参数。

相关文档

• UI
• Core
• PropertyGrid