🎯 事件系统¶
事件系统用于为组件添加交互功能,实现用户与界面的交互行为。
📍 访问事件编辑器¶
事件编辑器位于属性面板的"事件"标签页中:
- 选中要添加事件的组件
- 在右侧属性面板中,点击 "事件" 标签页
- 即可看到事件编辑器界面
🎨 事件系统概述¶
事件系统允许您为组件配置交互行为,当用户与组件交互时(如点击、长按等),可以触发相应的动作(如页面跳转、修改属性等)。
事件系统工作流程¶
用户交互 → 触发事件 → 执行动作 → 界面响应
例如:
- 用户点击按钮 → 触发 LV_EVENT_CLICKED 事件 → 执行"页面跳转"动作 → 跳转到目标页面
➕ 添加事件¶
步骤 1:打开事件编辑器¶
- 选中要添加事件的组件
- 在属性面板中找到 "事件" 标签页
- 点击 "添加事件" 按钮
步骤 2:选择事件类型¶
选择触发事件的条件,常用事件类型包括:
输入交互事件 - LV_EVENT_CLICKED:组件被点击时触发(最常用) - LV_EVENT_DOUBLE_CLICKED:组件被双击时触发 - LV_EVENT_LONG_PRESSED:组件被长按时触发 - LV_EVENT_PRESSED:组件被按下时触发 - LV_EVENT_RELEASED:组件被释放时触发
焦点事件 - LV_EVENT_FOCUSED:组件获得焦点时触发 - LV_EVENT_DEFOCUSED:组件失去焦点时触发
值变化事件 - LV_EVENT_VALUE_CHANGED:组件值改变时触发(如滑块移动、输入框输入)
滚动事件 - LV_EVENT_SCROLL:组件滚动时触发
步骤 3:选择动作类型¶
选择事件触发后要执行的动作:
- 页面跳转:跳转到指定页面
- 修改属性:修改组件的一个或多个属性值
- 修改样式:修改组件的一个或多个样式属性
- 调用函数:调用自定义函数
步骤 4:配置动作参数¶
根据选择的动作类型,配置相应的参数:
页面跳转参数¶
目标页面 - 从下拉列表中选择要跳转到的页面
动画类型 - none:无动画 - fade_in / fade_out:淡入淡出 - move_left / move_right / move_top / move_bottom:滑动效果 - over_left / over_right / over_top / over_bottom:覆盖效果 - out_left / out_right / out_top / out_bottom:移出效果
动画时长 - 设置动画持续时间(毫秒),默认 300ms
动画延迟 - 设置动画延迟时间(毫秒),默认 0ms
修改属性参数¶
目标组件 - 选择要修改的组件(默认为当前组件) - 可以从下拉列表中选择页面中的其他组件
属性列表 - 点击 "添加属性" 按钮 - 选择要修改的属性(如 Text、Width、Height 等) - 输入新的属性值 - 可以添加多个属性修改项
修改样式参数¶
目标组件 - 选择要修改的组件(默认为当前组件)
样式部分 - 选择要修改的样式部分(如 Main、Indicator、Scrollbar 等)
样式状态 - 选择要修改的样式状态(如 Default、Pressed、Focused 等)
样式属性列表 - 点击 "添加样式属性" 按钮 - 选择要修改的样式属性(如背景颜色、字体大小、边框宽度等) - 输入新的样式属性值 - 可以添加多个样式属性修改项
调用函数参数¶
函数名
- 输入要调用的函数名称(如 handleButtonClick)
步骤 5:保存事件¶
- 可选:添加事件描述(用于说明事件用途,便于后续维护)
- 点击 确认 按钮保存事件
- 事件将出现在事件列表中
✏️ 编辑事件¶
编辑现有事件¶
- 在事件列表中点击要编辑的事件
- 修改事件类型、动作类型或参数
- 点击 确认 按钮保存修改
删除事件¶
有两种方式删除事件:
方式 1:从事件列表删除 - 在事件列表中,点击事件右侧的 删除 按钮 - 确认删除操作
方式 2:从编辑模式删除 - 点击事件进入编辑模式 - 点击编辑表单头部的 删除 按钮 - 确认删除操作
📋 事件列表¶
事件列表显示当前组件的所有事件,包括:
- 事件类型:显示触发条件(如 CLICKED、LONG_PRESSED)
- 动作类型:显示执行的动作(如页面跳转、修改属性)
- 描述:显示事件描述(如果有)
- 操作按钮:编辑、删除
🎯 事件连线可视化¶
在画布中,您可以查看事件与目标组件之间的连线关系:
- 在画布工具栏的 视图 菜单中,选择 显示事件连线
- 画布中将显示事件与目标组件之间的连线
- 点击连线可以快速定位到对应的事件配置
🔗 相关功能¶
工作台文档:← 返回工作台 | 画布 | 组件库 | 组件树 | 属性面板 | 事件系统 | 多语言 | 工具栏 | 快捷键