4. 事件交互

通过添加事件，可以为控件创建不同的交互效果，如加载屏幕、更改大小、播放动画等效果。

4.1 选中事件源控件

在画布上选中需要添加事件的控件（如按钮、矩形、滑动条等），在事件选项卡中点击添加按钮为该控件添加一个事件。

event add default event

4.2 事件命名

点击添加按钮之后，事件会自动创建并生成默认的命名。可以保持不变，也可以修改方便后续管理事件。

注意：事件命名需要避免和其余控件命名重复，也需要避免使用中文和其余的C语言关键字，否则编译阶段会报错。

event add default event

4.3 触发方式

事件命名之后，选择事件的触发方式：

按下时：点击控件后会触发事件
长按时：点击控件并保持按住会触发事件
松开时：在点击后松开时触发
滑动时：需要在点击控件之后移动鼠标或手指滑动（单片机上运行）才会触发

注：只在分组和滑窗中才可选的触发方式，其作用于当该控件的子控件被内核释放内存时执行自定义代码片段。

trigger methods trigger group slide

4.4 事件目标控件

选择事件的目标控件。可以选择事件发生时需要变更的控件，可以选择的控件有：源控件所在屏幕内的所有控件、该项目中其余的屏幕控件，也可以设置为自定义代码添加代码片段。

target controls

4.5 触发事件

当设置目标控件之后，可以为该控件设置对应的事件。不同类型的控件所能触发的事件不同。

通用的触发事件：

位置变化 / X变化 / Y变化
大小变化 / W变化 / H变化
圆角变化 / 获取进度 / 更新文本
透明度变化
隐藏（与透明度变化设置为0的隐藏不同，隐藏事件同时也会隐藏点击的区域）
移动动画（与位置变化事件不同，该事件存在移动的过程效果）
禁用控件 / 解禁控件

存在背景颜色的控件额外事件： 背景颜色变化

存在文本内容的控件额外事件： 字体颜色变化、文本变化

标签控件特殊事件： 获取进度(百分比) — 可以获取幻灯片、滑动条和进度条的显示进度

输入框控件特殊事件： 删除字符、添加字符

幻灯片控件特殊事件： 加载上一个图片、加载下一个图片、开始/暂停播放

计数器控件特殊事件： 递增（按设定的步进值增加）、递减（按设定的步进值减少）、数值变化（变更为新值）

时钟控件特殊事件： 增加1秒、开启时钟、暂停时钟、开启/暂停时钟

屏幕控件特殊事件：

加载屏幕：保存当前屏幕的显示效果并切换显示到另一屏幕控件
返回上一界面：当前屏幕界面有多个屏幕入口时，在返回按键添加该事件，由当前屏幕返回到上一个屏幕入口

trigger events list

4.6 事件编辑

选中触发事件之后，会在触发事件下方显示该事件的具体设置。不同事件对应设置不同：

通用设置：

位置变化：在出现的X和Y编辑框中填入新的X和Y值
大小变化：在出现的W和H编辑框中填入新的W和H值
透明度变化：在出现的透明度滑动条中拖动修改透明度
隐藏：在下方出现的选项中勾选隐藏
移动动画：在下方出现的X和Y值中填入移动到的位置，延时时间为触发事件后需要多久开始移动，持续时间为移动到目标位置所需时间
禁用控件 / 解禁控件：无需继续配置

背景颜色/字体颜色变化： 在出现的颜色列表中选择需要更改的颜色

文本变化： 在出现的文本框中输入变化后的文本

获取进度(百分比)： 在出现的获取进度控件中选择幻灯片控件并设定显示的文本内容

输入框特殊设置： 删除字符（每次触发删除一个字符）、增加字符（在文本框中输入要增加的字符）

幻灯片特殊设置： 加载上一个/下一个图片、开始/暂停播放（无需继续配置）

计数器特殊设置： 递增、递减（无需继续配置）；数值变化（在数值框内设定新的计数值）

时钟特殊设置： 增加1秒、开启/暂停/开启暂停时钟（无需继续配置）

屏幕特殊设置： 加载屏幕（无需继续配置）

label text change event edit config

4.7 控件与事件注释

当设置目标控件之后，可以在该控件属性添加注释，最终添加的控件注释在程序代码中可查看。同样，也可以针对事件添加注释，最终添加的事件注释在程序代码中可查看。

control comment property control comment code event comment code