对象检查器
对象检查器位于设计器右侧，用于查看和编辑选中组件的 属性 和 事件。当在设计画布或项目管理器中选中组件时，对象检查器自动同步显示该组件的信息。
界面组成
对象检查器由以下部分组成：
- 搜索框 - 顶部搜索框，支持按属性名过滤
- 标签页 - 两个标签页：属性 和 事件
- 文档区 - 底部预留的属性文档提示区域（开发中）
属性编辑
属性列表
属性列表以表格形式显示，包含两列：
| 列 | 说明 |
|---|---|
| Name | 属性名称 |
| Value | 属性当前值，可点击编辑 |
属性编辑方式
不同类型的属性使用不同的编辑器：
| 属性类型 | 编辑方式 | 说明 |
|---|---|---|
| 文本 (Text) | 文本输入框 | 直接输入文本值 |
| 整数 (Int) | 数字输入框 | 输入整数值 |
| 浮点数 (Float) | 数字输入框 | 输入浮点数值 |
| 布尔 (CheckBox) | 复选框 | 勾选/取消勾选 |
| 枚举 (ComboBox) | 下拉框 | 从预定义选项中选择 |
| 集合 (Set) | 复选列表 | 多选设置集合值 |
| 颜色 (Color) | 颜色选择器 | 弹出颜色选择对话框 |
| 类实例 (Class) | 特殊处理 | 如 Icon 属性弹出图标编辑器 |
| 事件 (Method) | 下拉框 | 选择或输入事件处理函数名 |
| 字符 (Uint16) | 文本输入框 | 输入单字符或多字符串 |
修改属性值
- 在属性列表中 单击 要修改的属性值列
- 根据属性类型出现对应的编辑器
- 输入或选择新值
- 按
Enter或点击其他位置确认修改
属性修改效果
属性修改后：
- 设计画布上的组件 实时更新 显示效果
- UI 布局文件自动同步更新
- 已修改的属性值以 蓝色 高亮显示
- 颜色属性的值以对应 颜色 显示
属性分组
某些组件的属性按子对象分组显示，如 Font.Size、Font.Style 等。展开分组可查看和编辑子属性。
事件绑定
事件列表
事件列表同样以表格形式显示：
| 列 | 说明 |
|---|---|
| Name | 事件名称（如 OnClick、OnChange 等） |
| Value | 事件处理函数名，下拉框选择或手动输入 |
绑定事件
- 切换到 事件 标签页
- 找到要绑定的事件（如
OnClick） - 单击 Value 列，出现下拉框
- 从下拉框中选择已有函数，或手动输入新的函数名
- 按
Enter确认
事件代码生成
绑定事件后，设计器自动：
- 在用户的
.go文件中生成对应的事件处理函数 - 函数签名符合 ENERGY 框架规范
- 使用 AST 技术保护用户已编写的代码不被覆盖
支持的常见事件
| 事件名 | 触发时机 |
|---|---|
| OnClick | 鼠标单击 |
| OnDblClick | 鼠标双击 |
| OnMouseDown | 鼠标按下 |
| OnMouseUp | 鼠标抬起 |
| OnMouseMove | 鼠标移动 |
| OnChange | 值改变 |
| OnKeyPress | 按键按下 |
| OnKeyDown | 键盘按下 |
| OnKeyUp | 键盘抬起 |
| OnEnter | 获得焦点 |
| OnExit | 失去焦点 |
| OnResize | 大小改变 |
| OnShow | 窗体显示 |
| OnClose | 窗体关闭 |
属性与 Go 代码的关系
对象检查器中修改的属性值会自动生成到 Go 代码中。生成规则：
- 属性修改生成
Set{属性名}(值)调用 - 例如：
Caption = "Hello"→m.SetCaption("Hello") - 枚举类型使用
lclTypes.前缀 - 集合类型使用
lclTypes.NewSet(...)形式
属性同步
以下操作会触发属性列表同步更新：
- 在设计画布上选中不同组件
- 在项目管理器中点击组件树节点
- 切换设计窗体标签页
- 组件拖拽或调整大小后