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 点位置。

例如，如需围绕表盘的顶部四分之一圆显示曲线文本，请将 startAngle 设为 335.0并将 endAngle 设为 45.0。

这些属性是可转换的。

可选属性

以下属性是可选属性：

direction

指示文本的书写方向：

• CLOCKWISE（默认）：按顺时针方向显示文本。
• COUNTER_CLOCKWISE：按逆时针方向显示文本。

align

确定文本在其父元素中的对齐方式：

• START：左对齐或上对齐（当前语言使用 RTL 文本方向时为右对齐）
• CENTER：居中对齐
• END：右对齐或下对齐（当前语言使用 RTL 文本方向时为左对齐）

默认值为 CENTER。

ellipsis

一个布尔值，用于指示在文本过长，不适合父元素时，是否显示省略号。默认值为 FALSE。

内部元素

Text 元素可以包含任意数量的以下内部元素：

• Transform
• Font
• BitmapFont