PartText

1 つのテキスト レイアウト要素を含むウォッチフェイスの部分を表します。

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

要素が回転する際の軸となる 2 次元のピボット ポイント。どちらの値も浮動小数点数であり、$ [0, 1] $ の範囲に収まるように調整されます。

これらの属性は「変換可能」です。

angle

ピボット ポイントを軸にして要素が回転する時計回りの角度。

この属性は変換可能です。

alpha

この要素に必要な透過性レベルを設定します。値 0 は要素が完全に透明であることを表します。値 255 は要素が完全に不透明であることを表します。

この属性は変換可能です。

name

この要素を識別する文字列です。ウォッチフェイス ファイル内の別の場所からこの要素を参照する必要がある場合に便利です。

scaleX

この要素に適用する水平方向のスケーリング ファクタ。

この属性は変換可能です。

scaleY

この要素に適用する垂直方向のスケーリング ファクタ。

この属性は変換可能です。

renderMode

要素の表示モードタイプ。有効な値は SOURCE（デフォルト）、MASK、ALL です。

tintColor

要素に色合い調整フィルタを適用します。色の指定には、ARRGB 形式（#ff000000 = 不透明な黒）または RGB 形式（#000000 = 黒）を使用します。

内部要素

PartText 要素には、次の内部要素を含めることができます。Text または TextCircular が内部要素のいずれかであることを除き、すべての要素は省略可能です。PartText 要素には、各内部要素を無制限に含められます（それぞれ 1 回までしか表示できない Text、TextCircular、Localization、Gyro、Launch、ScreenReader は除く）。

• Text
• TextCircular
• Localization
• Transform
• Variant
• Gyro
• Launch
• ScreenReader