3.6 TFT【功能】按钮控件

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

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

功能按钮

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

一、功能设置

1. 按钮用途：选择[切换画面、打开对话框、关闭对话框、虚拟按键、打开菜单、关闭菜单、批量传批]。

不同用途说明见后

2. 执行时机：选择[按下时、松开时、长按时]。

• 长按时

2.1 按压毫秒：长按的时长，单位ms，范围500~20000。

3. 条件触发：选择[禁用、启用]。启用时，当达到触发条件，相当于点击了控件。

3.1 条件地址：选择要比较的地址。

3.2 比较：选择[==, !=, <=, >=, <, >, IN, OUT]。当选中IN/OUT时，显示下限值/上限值属性。

3.3 值：输入要比较的值。

3.4 下限值：输入要比较的值。

3.5 上限值：输入要比较的值。

4. 通知功能：选择[启用、禁用]。

4.1 通知地址：选择要通知的地址。控件执行完成后，向该地址写入指定值。

4.2 写值：写入通知地址的值。

5. 播放声音：选择[禁用、启用]。

5.1声音文件：选择声音文件。更多选项通过[工程]-[声音]添加或删除。

用途A：切换画面

A.1 目标画面：选择要切换的目标画面。

A.2 动画效果：选择[无、左右、右左、上下、下上、渐变弹窗]。

用途B：打开对话框

B.1 目标画面：选择要打开画面作为对话框。

B.2 背景蒙版：设置对话框以外区域的不透明度。范围0~100。

B.3 动画效果：选择[无、左右、右左、上下、下上、渐变弹窗]。

B.4 弹窗位置：选择[默认、自定义]。

B.4.1 X坐标：自定义弹窗的X坐标。

B.4.2 Y坐标：自定义弹窗的Y坐标。

用途C：关闭对话框

C.1 动画效果：选择[无、左右、右左、上下、下上、渐变弹窗]。

用途D：虚拟按键

D.1 按键：选择[字符、切换键盘、Enter、ESC、Clear、Delete、Left、Right、Shift、Space]。

D.2 字符：最多可设置4个字符，跟随键盘切换。

D.3 键盘画面：切换至目标键盘画面。

用途E：打开菜单

E.1 目标画面：选择要打开画面作为菜单。

E.2 背景蒙版：设置菜单以外区域的不透明度。范围0~100。

E.3 动画效果：选择[无、左右、右左、上下、下上、渐变弹窗]。

E.4 弹窗位置：选择[默认、自定义]。

E.4.1 X坐标：自定义弹窗的X坐标。

E.4.2 Y坐标：自定义弹窗的Y坐标。

E.5 菜单返回地址：接收“关闭菜单”的返回值的地址。

 

用途F：关闭菜单 

F.1 菜单返回值：关闭菜单时的值，将传给打开菜单时的菜单返回地址。

用途G：批量传输

G.1 目标地址：批量传输写入地址。

G.2 源地址：批量传输读取地址。

G.3 寄存器个数：批量传输的寄存器个数。1个寄存器是2个字节。

 

二、状态设置

• 

  1. 使用图片：选择否或是。

  1.1.状态图片：

  

  • • 图库素材：内置一些SVG格式图片，可点击【颜色...】修改主颜色。
    • 插入图片...：选择外部图片(png/jpg/svg)，无法在这里修改颜色。注svg仅支持低于1.2tiny版

    • 状态 0 图库：控件状态为 0时， 显示的图片。

    • 状态 1 图库：控件状态为 1时， 显示的图片。

  1.2裁剪：选择缩放图片以适应控件大小，即控件尺寸不变；缩放控件以适应图片大小，即按图片大小缩放控件。

  2. 使用文字：选择否或是。

  2.1默认字体：字体名称，通过[工程]-[字库]添加或删除。

  2.2字体大小：字体尺寸，范围8~500。

  2.3字间距：相邻字符之间的间距，范围0~255。

  2.4使用标签：选择[否、是]。

  2.5选择状态：选择[ALL、S0、S1]。

  • • ALL：修改下面的子属性时，将同时修改所有状态对应的属性。
    • S0/S1：修改下面的子属性时，仅对选中状态有效。

  2.5.1文字内容：不使用标签时，需输入文字内容。

          标签：使用标签时，指定标签，通过[工程]-[文字标签]添加或删除。

  2.5.2颜色：文字颜色。

  2.5.3对齐：仅支持水平对齐，选择[左、中、右]。

  2.5.4闪烁：选择[无、0.5秒、1秒]。

  2.5.5跑马灯：选择[无、左移动、右移动、下移动、上移动]。

  2.5.5.1速度：文字跑马灯效果移动速度(像素/秒)：1~10000。

  2.6详细设置：多语言多状态下指定不同的字体

  

  修改ALL行时，将同时修改S0/S1的属性

  当使用标签时，下方多语言表中，不可再指定标签

  当不使用标签时，下方多语言表中，可输入内容

三、应用示例

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

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

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

演示【切换画面】

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运行