AnalogClock


AnalogClock 元素是存放 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
與元素旋轉方向相關的 2D 樞紐點。兩個值都是浮點數,可在 $ [0, 1] $ 範圍內視需求調整。
angle
元素應以順時針方向從樞紐點旋轉的角度數值。
alpha
此屬性可設定元素應具備的透明度。如果值為 0,表示元素應完全透明;如果值為 255,則表元素應完全不透明。
scaleX
要套用至此元素的水平縮放比例係數。
scaleY
要套用至此元素的垂直縮放比例係數。
renderMode
元素的算繪模式類型。可能的值包括:SOURCE (預設值)、MASKALL
tintColor
為元素套用色調顏色濾鏡。您必須使用 ARGB 格式 (#ff000000 = 不透明黑) 或 RGB 格式 (#000000 = 黑) 指定顏色。

內部元素

AnalogClock 元素可包含下列內部元素:

HourHand
MinuteHand
SecondHand
三者分別是代表時針、分針和秒針的元素,會在錶面旋轉。AnalogClock 最多可包含 2 個時針、2 個分針和 2 個秒針。
Localization
提供算繪時間時所使用語言代碼的提示。詳情請參閱 Localization 參考資料。

AnalogClock 元素最多只可包含一個 Localization 元素。

Variant
允許在 Wear OS 裝置處於微光模式時,變更元素屬性。詳情請參閱 Variant 參考資料。