AnalogClock

表盘格式版本 版本 3 版本 2 版本 1

---

模拟时钟是 AnalogHands 内部元素的容器，用于显示围绕表盘旋转的一系列时钟指针。

此元素在 Wear OS 4 中推出。

语法

<AnalogClock x="integer" y="integer" width="integer" height="integer"
             pivotX="float" pivotY="float" angle="float-degrees" alpha="integer"
             scaleX="float" scaleY="float"
             renderMode="[SOURCE | MASK | ALL]"
             tintColor="argb-color | rgb-color">
    <!-- This is the maximum number of hands that you can define. -->
    <HourHand ... />
    <HourHand ... />
    <MinuteHand ... />
    <MinuteHand ... />
    <SecondHand ... />
    <SecondHand ... />
</AnalogClock>

属性

AnalogClock 元素具有以下属性：

必需属性

以下属性是必需属性：

x、y、width、height

用于指定元素的大小和位置的整数集合。

可选属性

以下属性是可选属性：

pivotX、pivotY

表示元素围绕其旋转的二维轴心点。这两个值都是浮点数，且均会经过调整以符合 $ [0, 1] $ 这一范围。

angle

表示元素围绕轴心点顺时针旋转时应遵循的角度值。

alpha

用于设置此元素应具有的透明度。值 0 表示此元素应是完全透明的。值 255 表示此元素应是完全不透明的。

scaleX

要应用于此元素的横向缩放比例。

scaleY

表示要应用于此元素的纵向缩放比例。

renderMode

表示此元素的渲染模式类型。可能的值包括 SOURCE（默认）、MASK 或 ALL。

tintColor

对此元素应用色调滤镜。您必须使用 ARGB 格式（#ff000000 = 不透明的黑色）或 RGB 格式（#000000 = 黑色）来指定颜色。

内部元素

AnalogClock 元素可以包含以下内部元素：

HourHand

MinuteHand

SecondHand

这些元素分别表示围绕表盘旋转的时针、分针和秒针。AnalogClock 最多可包含 2 个时针、2 个分针和 2 个秒针。

Localization

提供在呈现时间时要使用的语言区域的相关提示。如需了解详情，请参阅 Localization 参考文档。

一个 AnalogClock 元素最多只能包含一个 Localization 元素。

Variant

允许在 Wear OS 设备处于氛围模式时更改此元素的属性。如需了解详情，请参阅 Variant 参考文档。