模拟时钟


模拟时钟是 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 元素具有以下属性

必需属性

以下属性是必需的

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

可选属性

以下属性是可选的

pivotXpivotY
元素围绕其旋转的二维枢轴点。这两个值都是浮点数,按比例缩放以适应范围 $[0, 1]$。
角度
元素应围绕其枢轴点顺时针旋转的度数。
alpha
设置此元素的透明度级别。值为0表示元素应完全透明。值为255表示元素应完全不透明。
scaleX
应用于此元素的水平缩放因子。
scaleY
应用于此元素的垂直缩放因子。
renderMode
元素的渲染模式类型。可能的值为:SOURCE(默认)、MASKALL
tintColor
将颜色着色滤镜应用于元素。必须使用ARGB格式(#ff000000 = 不透明黑色)或RGB格式(#000000 = 黑色)指定颜色。

内部元素

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

时针
分针
秒针
分别代表时针、分针和秒针的元素,它们围绕表盘旋转。AnalogClock最多可以包含2个时针,2个分针和2个秒针。
本地化
提供渲染时间时要使用的区域设置的提示。更多信息可在Localization 参考中找到。

AnalogClock元素最多可以包含一个Localization元素。

变体
允许在 Wear OS 设备处于环境模式时更改此元素的属性。更多信息可在Variant 参考中找到。