3.6 TFT功能按钮控件

版本	内 容 摘 要	日期
V1.0	首次发布	2026/6/14

**【例程下载】**[ApusTFT - 功能按钮控件(点击下载)]

功能按钮

1. 【功能】按钮主要用于界面上的操作，比如切换画面，打开或关闭对话框，打开或关闭菜单，虚拟按键，批量传输等

一、功能设置

1. 功能用途：

   ①　切换画面

• 目标画面：选择切换到的画面。

• 动画效果：选择画面切换时的动画过渡效果，无、从左到右、从右到左、从上到下、从下到上。

• ②　打开对话框

• 目标画面：选择指定画面。

• 背景蒙版：0-100,0为透明。

• 动画效果：选择画面切换时的动画过渡效果，无、从左到右、从右到左、从上到下、从下到上。

• 弹出位置：可指定位置坐标，默认屏幕居中显示。

  ③　关闭对话框

• 搭配打开对话框使用，按钮按下，关闭弹出对话框。

  ④　虚拟按键：配置键盘功能。

  ⑤　打开菜单：打开指定的菜单画面。

• 目标画面：选择指定画面。

• 背景蒙版：0-100,0为透明。

• 动画效果：选择画面切换时的动画过渡效果，无、从左到右、从右到左、从上到下、从下到上。

• 弹出位置：可指定位置坐标，默认屏幕居中显示。

• 菜单返回地址：接收“关闭菜单”里设置的返回值的寄存器地址。

  ⑥　关闭菜单：结合“打开菜单”使用。

• 菜单返回值：该值写入“打开菜单”设置的返回地址。

  ⑦　批量传输：批量复制寄存器内容。

• 目标地址：写入寄存器地址。

• 原地址：读取寄存器地址。

• 寄存器个数：复制个数。

  2.执行时机：设置寄存器的时机 ，可选按下时、弹起时执行。

  3.条件触发：当条件成立时执行动作(触发式)。

• 条件地址：执行条件的寄存器地址。

• 比较：支持基本的逻辑运算“>”、“=”、“b）。

• 值：条件对比的值。

  4.通知功能：控件被触发时发送通知。

• 通知地址：写入的寄存器地址。

• 值：给“通知地址”的写入值。

  5.播放声音：点击控件时，播放指定的声音文件（支持wav、mp3）。

二、状态设置

1. 使用图片：是否使用图库。按钮仅2个状态，分别表示松开和按下

• 松开时(状态0)图片：选择按钮松开状态下显示的图片文件。

• 按下时(状态1)图片：选择按钮按下状态下显示的图片文件。

• 裁剪：是或否，将上一选项选中的图片按照当前控件区域裁剪显示；

2. 使用文字：是否使用文字。

• 默认字体：选择默认字体。

• 字体大小：设置字体文字大小。

• 使用标签：选择设定的文字，详细参考标签章节。

• 选择状态：修改指定状态：按下时、松开时，全部状态选择 ALL；可设置状态的文字内容、颜色、对齐方式、是否闪烁、是否使用跑马灯效果等。

三、应用示例

分别演示切换画面、条件切换画面、打开/关闭对话框、打开/关闭菜单，界面控件如图：

【功能按钮】、【功能按钮】、【功能按钮】、【功能按钮】叠加【多状态指示灯】

【数值框】、【数值框】、【数值框】

演示【切换画面】

1.1新建画面，用于本功能，并在其左上角放置【功能按钮】，用于返回

返回【功能按钮】属性：

1.2 切换画面【功能】按钮控件属性

1.3 运行

点击切换画面【功能】按钮和返回【功能】按钮，观察效果

演示触发【条件切换】

2.1切换画面【功能】按钮控件属性

2.2 【数值】控件属性

2.3 运行

可以通过点击条件切换【功能】按钮进行切换窗口，也可以通过在【数值】控件中输入1进行切换。注意：在切换并返回后，数值框的值依然是1，如要重新触发，要先设为0。

演示打开/关闭【对话框】

1. 新建对话框画面，放置1个【文本】和2个【功能按钮】

   

   【功能按钮】“是”的控件属性：

   

   【功能按钮】“否”的控件属性：

   

   3.2 首页中对话框【功能按钮】按钮属性

   

   

   3.3 下面的【数值】控件属性(显示对话框中点了是还是否)

   

   

   3.4 运行

   在点击【对话框】及对话框中的【是】、【否】，查看【数值】变化。

   

演示打开/关闭【菜单】

1. 新建菜单画面，放入六个功能按钮：自动、制冷、制热、送风、除湿、睡眠

   

   【自动】按钮属性

   

   【制冷、制热、送风、除湿、睡眠】按钮属性类似，需相应修改【菜单返回值】分别为【1、2、3、4、5】，以及修改【文字内容】属性

   4.2 叠加的【多状态】指示灯控件属性

   

   

   

   4.3【功能】按钮控件属性

   

   

   4.4 【数值】控件属性(用于显示菜单返回值)

   

   

   4.5运行