數位時鐘是存放格式化字串組的容器,代表與時鐘時間相關聯的目前小時數、分鐘數和秒數。
這項元素已在 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
- 與元素旋轉方向相關的 2D 樞紐點。兩個值都是浮點數,可在 $ [0, 1] $ 範圍內視需求調整。
angle
- 元素應以順時針方向從樞紐點旋轉的角度數值。
alpha
- 此屬性可設定元素應具備的透明度。如果值為
0
,表示元素應完全透明;如果值為255
,則表元素應完全不透明。 scaleX
- 要套用至此元素的水平縮放比例係數。
scaleY
- 要套用至此元素的垂直縮放比例係數。
renderMode
- 元素的算繪模式類型。可能的值包括:
SOURCE
(預設值)、MASK
或ALL
。 tintColor
- 為元素套用色調顏色濾鏡。您必須使用 ARGB 格式 (
#ff000000
= 不透明黑) 或 RGB 格式 (#000000
= 黑) 指定顏色。
內部元素
DigitalClock
元素可包含下列內部元素:
TimeText
一組經過格式化的字串,顯示與目前時鐘時間相關聯的小時數、分鐘數和秒數。
Localization
- 提供算繪時間時所使用語言代碼的提示。詳情請參閱
Localization
參考資料。
DigitalClock
元素最多只可包含一個 Localization
元素。
Variant
- 允許在 Wear OS 裝置處於微光模式時變更元素屬性。詳情請參閱
Variant
參考資料。 ,瞭解如何調查及移除這項存取權。