• 在TouchGFX版本4.12.3中引入。

介绍

该Analog Clock窗口小部件是一个小部件，它使一个经典模拟表的显示，而不是在数字时钟，其时间显示与文本。时钟使用背景图像作为时钟面。时针，分针和秒针均使用图像，并围绕可配置的中心旋转。

本文介绍如何插入和更改模拟时钟小部件。给出了有关如何与实时时钟集成的指示。

Analog-clock-widget-in-misc-category.png

Analog Clock 位于TouchGFX Designer的其他类别中

重要属性 

位置 设置x，y 和  visible的性能Analog Clock。
出现 设置用于后台与该图像rotation center的Analog Clock。
时间

设置  initial time ＆是否  am/pm 在上使用  Analog Clock。

时钟指针

添加，编辑或删除时钟指针。 

设置要用于每个单独的时钟针rotation position 的图像以及用于时钟针的图像的。时针和分针还可以使动画产生横扫动作。

动画

设置移动时针时应使用的动画。

注意：如果时针启用了横扫运动，则时针将不使用动画。

用法

位置

的大小Analog Clock取决于在“外观”属性组中设置的背景图片的大小。要设置位置，请设置坐标属性x 并  y确定将其放置在左上角的Analog Clock位置。

模拟时钟位置道具

位置属性

出现

在外观选择器的图像选择器中设置了背景图像/时钟面，所选图像的大小也设置了整个小部件的大小。

旋转中心设置时钟指针图像旋转的点。

Analog-clock-appearance-props.png

外观特性

时间

“时间”属性组允许用户设置时钟小部件的初始时间以及是否使用Am / Pm标准。

选择Am / Pm也会导致代码生成略有变化。而不是使用以下函数Analog Clock来初始化时间： 

initializeTime24Hour（uint8_t小时，uint8_t分钟，uint8_t秒）

使用24小时表示法初始化时间

使用12小时表示法时使用此功能： 

initializeTime12Hour（uint8_t小时，uint8_t分钟，uint8_t秒，布尔）

使用12小时表示法初始化时间

要更新时钟显示的时间，可以使用以下功能之一。 

setTime24Hour（uint8_t小时，uint8_t分钟，uint8_t秒）

使用24小时制设置新时间 

setTime12Hour（uint8_t小时，uint8_t分钟，uint8_t秒，布尔上午）

使用12小时表示法设置新时间

模拟时钟时间道具

时间属性

时钟指针

在“时钟指针”属性组中，用户可以定义要使用的指针及其顺序。首先定义的指针将显示在其他指针的上方，在上面的图片中，这表示时钟显示00:00:00，时针将显示在分针和秒针的顶部。

Analog-clock-hands-props.png

时钟指针

时针，分针和秒针

每只手都需要一个图像和一个旋转位置。旋转位置确定所定义的手形图像应围绕自身旋转的点。

模拟时钟小时手props.png模拟时钟分钟道具模拟时钟第二手道具

钟针属性

时针和分针可以使用“扫动”功能，启用此选项后，指针将不再起作用，并且瞬时从一个位置跳到另一位置。

模拟时钟无扫频运动.gif

扫动禁用

Analog-clock-with-sweeping-movement.gif

启用扫掠运动

动画

动画部分允许用户定义更高级的指针运动，但是，如果时针和分针启用了“横扫运动”，则它们将不进行动画处理。

模拟时钟动画道具

动画属性

在以下示例中，动画的持续时间设置为“ 30”，缓动设置为“弹跳”，缓动选项设置为“出”：

模拟时钟动画

时钟动画示例