3.15 TFT仪表指针控件

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

**【例程下载】**[ApusTFT - 仪表指针控件(点击下载)]

仪表指针

一、功能设置

1.读取地址：此地址对应的值就是仪表指针的指向的值。

2.数据类型：略

3.开始值：起始数值。

4.终止值：终止数值。

外观设置

1.指针方向：统一使用向右的指针，不可选择；

2.指针图片：用户制作的图片指针必须向右；如右图

3.开始角度：参照笛卡尔坐标系(向右是0度，向上是90度)的角度值；

4.占用角度：即该表盘刻度区间所占用的角度

5.旋转方向：表盘刻度方向。

6.旋转中心X：设置指针旋转中心的X坐标

7.旋转中心Y：设置指针旋转中心的Y坐标

如表盘图：

• 开始角度：刻度0处的角度值，为225度

• 占用角度：刻度0处到刻度240处的刻度盘的角度范围，为270度

• 旋转方向：从刻度0到240，为顺时针方向

• 旋转中心坐标：相对于指针图片自身左上角的坐标(屏幕坐标系：即向右是x正方向，向下是y正方向)

• 旋转中心X：一般取0

• 旋转中心Y：一般取指针图片高度的一半

  如指针图片

  旋转中心X可设为0，旋转中心Y可设为6（高度的一半）。

  

三、应用示例

1.演示

如下图，依次放入控件：

【仪表指针】、【仪表指针】

【字设置按钮】、【数值】、【字设置按钮】：中间的”+”和”-”

*注：表盘为背景图片，并非与仪表指针一体

1. 左【仪表指针】控件属性

   

   

2. 右【仪表指针】控件属性

   

   

3. 中间【数值】控件属性

   

   

4. 左【字设置】控件属性

   

   

5. 左【字设置】控件属性

   

   

   1.6 运行

   点击或按住【字设置】控件或修改【数值】输入框的值，观察效果