模拟时钟是一个容器,用于 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] $。
角度
- 元素围绕其轴心点顺时针旋转的度数。
alpha
- 设置此元素应具有的透明度级别。值
0
表示元素应完全透明。值255
表示元素应完全不透明。 scaleX
- 要应用于此元素的水平缩放因子。
scaleY
- 要应用于此元素的垂直缩放因子。
renderMode
- 元素的渲染模式类型。可能的值是:
SOURCE
(默认)、MASK
或ALL
。 tintColor
- 对元素应用色调颜色过滤器。您必须使用 ARGB 格式 (
#ff000000
= 不透明黑色) 或 RGB 格式 (#000000
= 黑色) 指定颜色。
内部元素
AnalogClock
元素可以包含以下内部元素
时针
分针
秒针
- 分别代表时针、分针和秒针的元素,它们围绕表盘旋转。
AnalogClock
最多可以包含 2 个时针、2 个分针和 2 个秒针。 本地化
- 提供渲染时间时要使用的语言环境的提示。有关更多信息,请参见
Localization
参考。
AnalogClock
元素最多可以包含一个 Localization
元素。
变体
- 允许在 Wear OS 设备处于环境模式时更改此元素的属性。有关更多信息,请参见
Variant
参考。