TextCircular

此元素可指定環形或弧形文字設定。

這項元素已在 Wear OS 4 推出。

語法

<TextCircular centerX="float" centerY="float"
              direction="CLOCKWISE | COUNTER_CLOCKWISE" width="float"
              height="float" startAngle="float-degrees"
              endAngle="float-degrees" align="START | CENTER | END"
              ellipsis="boolean" >
    <!-- Possible inner elements. The PartText element syntax shows a
         more complete example. -->
    <Transform .../>
    <Font ... />
    <BitmapFont ... />
</TextCircular>

屬性

TextCircular 元素包含下列屬性，分為必要和選用屬性。

必要屬性

必要屬性包括：

centerX 和 centerY
這組浮點值用於指定元素的中心位置。
width 和 height
這組浮點值用於指定元素的大小。
startAngle 和 endAngle

這組浮點值分別指定文字起始側和結尾側的角度。0 度角代表錶面的 12 點鐘位置。

舉例來說，如要沿著錶面頂端四分之一的圓邊加上弧形文字，請使用 335.0 的 startAngle 和 45.0 的 endAngle。

選用屬性

選用屬性包括：

direction

此屬性用於表示寫入文字的方向：

  • CLOCKWISE (預設)：按順時針方向顯示文字。
  • COUNTER_CLOCKWISE：按順逆針方向顯示文字。
align

此屬性可決定文字在父項元素中的對齊方式：

  • START：靠左或靠上對齊 (如果目前所用語言的文字方向為從右到左，則靠右對齊)
  • CENTER：置中對齊
  • END：靠右或靠下對齊 (如果目前所用語言的文字方向為從右到左，則靠左對齊)

預設值為 CENTER。

ellipsis

這個布林值可指示當文字過長而無法納入父項元素中時，是否要顯示刪節號。預設為 FALSE。

內部元素

Text 元素可包含任意數量的下列內部元素：