组件文本

表示表盘的一部分，其中包含恰好一个文本布局元素。

在 Wear OS 4 中引入。

语法

<PartText x="integer" y="integer" width="integer" height="integer"
           pivotX="float" pivotY="float" angle="float-degrees" alpha="integer"
           name="string" scaleX="float" scaleY="float"
           renderMode="[SOURCE | MASK | ALL]"
           tintColor="argb-color | rgb-color">
    <!-- Text-specific child elements. -->
    <Text>
        <!-- There must be raw text as the leaf inner element within a
            "PartText" element tree. -->
        <Font family="font" size="20" color="#00FFFF">Hello world
        </Font>
        <Font>
            <!-- Example of a text decoration element. -->
            <Outline>
                <!-- Example of a template with 2 string values. -->
                <Template>%s %s
                    <Parameter expression="[MONTH_S]" />
                    <Parameter expression="[DAY]" />
                </Template>
            </Outline>
            <!-- Example of a text formatting element. -->
            <Upper>
                <Template ... />
            </Upper>
            <Template ... />
        </Font>
    </Text>
    <!-- A "PartText" element can contain this "TextCircular" element instead
         of a "Text" element. -->
    <TextCircular centerX="180" centerY="180" direction="COUNTER_CLOCKWISE"
                  endAngle="90" height="340" width="340" startAngle="270">
        <!-- There must be raw text as the leaf inner element within a "PartText"
        element tree. -->
        <Font family="font" size="20" color="#00FFFF">Hello world
        </Font>
        <Font>
            Example of a text decoration element.
            <Outline>
                Example of a template with 2 string values.
                <Template>%s %s
                    <Parameter expression="[MONTH_S]" />
                    <Parameter expression="[DAY]" />
                </Template>
            </Outline>
            Example of a text formatting element.
            <Upper>
                <Template ... />
            </Upper>
            <Template ... />
        </Font>
    </TextCircular />
    -->

    <!-- Child elements that are shared across all "Part" elements. -->
    <Localization .../>
    <Transform .../>
    <Variant .../>
    <Gyro .../>
    <Launch .../>
    <ScreenReader .../>
</PartText>

属性

PartText 元素具有以下属性

必需属性

以下属性是必需的

x、y、width、height

一组整数，用于指定元素的大小和位置。

这些属性是可变换的。

可选属性

以下属性是可选的

pivotX、pivotY

元素绕其旋转的二维枢轴点。两个值都是浮点数，按比例缩放以适合范围$[0, 1]$。

这些属性是可变换的。

angle（角度）

元素应围绕其枢轴点顺时针旋转的度数。

此属性是可变换的。

alpha（透明度）

设置此元素应具有的透明度级别。值为0表示元素应完全透明。值为255表示元素应完全不透明。

此属性是可变换的。

name（名称）

标识此元素的字符串。如果您需要从表盘文件的另一个位置引用此元素，则此属性很有用。

scaleX（水平缩放）

应用于此元素的水平缩放因子。

此属性是可变换的。

scaleY（垂直缩放）

应用于此元素的垂直缩放因子。

此属性是可变换的。

renderMode（渲染模式）

元素的渲染模式类型。可能的值为：SOURCE（默认）、MASK 或 ALL。

tintColor（色调颜色）

将色调颜色滤镜应用于元素。必须使用 ARGB 格式（#ff000000 = 不透明黑色）或 RGB 格式（#000000 = 黑色）指定颜色。

内部元素

PartText 元素可以包含以下内部元素。所有元素都是可选的，但Text 或 TextCircular 必须是其中一个内部元素。PartText 元素可以包含每个内部元素的无限多个——但Text、TextCircular、Localization、Gyro、Launch 和 ScreenReader 除外，它们最多只能出现 1 次。