数字时钟是一个容器,包含一组格式化的字符串,这些字符串代表与时钟时间相关的当前小时、分钟和秒。
在 Wear OS 4 中引入。
语法
<DigitalClock 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 only required inner element. --> <TimeText ... /> </DigitalClock>
属性
DigitalClock
元素具有以下属性
必填属性
以下属性是必需的
x
、y
、width
、height
可选属性
- 以下属性是可选的
- 一组整数,指定元素的大小和位置。
pivotX
、pivotY
- 元素围绕其旋转的二维旋转点。这两个值都是浮点数,其比例适合范围 $[0, 1]$。
角度
- 元素应围绕其旋转点顺时针旋转的度数。
alpha
- 设置此元素应具有的透明度级别。
0
值表示元素应完全透明。255
值表示元素应完全不透明。 scaleX
- 应用于此元素的水平缩放因子。
scaleY
- 应用于此元素的垂直缩放因子。
renderMode
- 元素的渲染模式类型。可能的值为:
SOURCE
(默认)、MASK
或ALL
。 tintColor
- 将色调颜色滤镜应用于元素。必须使用 ARGB 格式(
#ff000000
= 不透明黑色)或 RGB 格式(#000000
= 黑色)指定颜色。
内部元素
DigitalClock
元素可以包含以下内部元素
时间文本
一组格式化的字符串,用于显示与当前时钟时间相关的小时、分钟和秒。
本地化
- 提供渲染时间时要使用的区域设置的提示。更多信息可在
Localization
参考中找到。
一个DigitalClock
元素最多可以包含一个Localization
元素。
变体
- 允许在 Wear OS 设备处于环境模式时更改此元素的属性。更多信息可在
Variant
参考中找到。