19. 指针控件

用途：指针控件是一种用于显示仪表盘或指示器的控件。它可以通过旋转指针来表示数值的变化，直观地反映当前状态或读数。

19.1. 属性

基础属性 : 参考控件概念- 基础属性

坐标属性 : 参考控件概念- 坐标属性

背景属性 : 参考控件概念- 背景属性

加载属性 : 参考控件概念- 加载属性

特有属性 :

• 当前角度(val)：当前指针角度 范围：0-360 默认：0 （3点钟方向）（读写）

• 起始角度(start): 起始偏移角度值，范围：0-360。 实际显示角度 = 当前角度 + 起始角度。如果关联RTC后指向不对，可调整该值(读写)

• 指针类型(style):指针类型形状，0-长方形，1-图片（只读）

• 关联RTC(rtc)：关系RTC信息，0-无，1-时，2-分，3-秒（只读）

当 指针类型(style) 为 0-长方形 时, 属性如下图所示

• 指针颜色(color)：指针颜色，0-65535（读写）

• 宽度(wid)：指针的宽度(像素点)，范围：0-32768（读写）

• 高度(hig)：指针的高度(像素点)，范围：0-32768（读写）

• 中心偏移(rofs)：指针旋转位置与控件中心点的偏移位置。rofs=0时，矩形的左中点在控件的中心位置处。rofs>0时，远离控件中心点，rofs<0时，靠近控件中心点（读写）

当 指针类型(style) 为 1-图片 时, 属性如下图所示

• 图片(pic)：图片ID资源，范围0-65535，65535表示无（读写）

• 旋转x坐标(x)：图片旋转中心横坐标，图片左上角为原点。x=0时，图片左上角在控件中心位置，正数朝左移，负数朝右移（读写）

• 旋转y坐标(y)：图片旋转中心纵坐标，图片左上角为原点。y=0时，图片左上角在控件中心位置，正数朝上移，负数朝下移（读写）

---

19.2. 事件

弹起事件： 控件按下且弹起后执行

按下事件： 控件按下后执行

---

19.3. 功能演示

点击下载演示工程

小技巧

把工程配置的启动页面(pid)改为当前页面ID可以立即显示此页面。

19.3.1. 指针配合RTC实现时钟功能

• 功能：指针和RTC配合，实现时钟功能

• 原理：表盘使用图片控件显示，时分秒使用指针控件去实现分别关联RTC的时分秒功能，同时使用RTC控件实时显示当前时间。

  • 创建一个图片控件，指定图片为变盘图片ID

  • 创建三个指针控件，指定指针类型为图片，分别指定对应指针的图片ID，并在特有数据中关联RTC对应的功能

  1、秒针指针控件属性

  

  2、分针指针控件属性

  

  3、时针指针控件属性

  

注意

当指针类型为图片时，注意修改图片的旋转坐标。左上角为图片旋转的零点。

• 添加一个RTC控件，修改显示格式、字体、文本颜色

  

• 选中图片控件和三个指针控件使用布局->中间对齐+居中对齐

19.3.2. 指针360度旋转

• 功能：指针和定时器配合，实现360度旋转

• 原理：在定时器事件中循环更新指针角度

  在 定时器事件 中编写以下脚本

  // 进度条控件最大值为：100, 超过100系统默认改为100
  if(g2.val==360)  // 当进度值为100时，设为0
  {
      g2.val=20;
  }
  else
  {
      g2.val+=20;
  }