3.15 TFT【仪表指针】控件

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

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

仪表指针

一、功能设置

1.读取地址：控件将读取该地址的值。

2.数据类型：选择[UINT16、INT16、UINT32、INT32]。

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

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