Teiltext

Stellt den Teil eines Zifferblatts dar, der genau ein Textlayoutelement enthält.

Eingeführt in Wear OS 4.

Syntax

<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>

Merkmale

Das PartText-Element hat die folgenden Attribute:

Erforderliche Attribute

Die folgenden Attribute sind erforderlich:

x, y, width, height
Eine Sammlung von Ganzzahlen, die die Größe und Position des Elements angeben.

Optionale Attribute

Die folgenden Attribute sind optional:

pivotX, pivotY
Ein zweidimensionaler Drehpunkt, um den sich das Element dreht. Beide Werte sind Gleitkommazahlen, die so skaliert werden, dass sie in den Bereich $ [0, 1] $ passen.
angle
Eine Anzahl von Grad im Uhrzeigersinn, um die das Element um seinen Drehpunkt gedreht werden soll.
alpha
Legen Sie fest, wie transparent dieses Element sein soll. Der Wert 0 gibt an, dass das Element vollständig transparent sein soll. Der Wert 255 gibt an, dass das Element vollständig deckend sein soll.
name
Ein String, der dieses Element identifiziert. Dies ist hilfreich, wenn Sie in der Zifferblattdatei von einer anderen Stelle auf dieses Element verweisen müssen.
scaleX
Der horizontale Skalierungsfaktor, der auf dieses Element angewendet werden soll.
scaleY
Der vertikale Skalierungsfaktor, der auf dieses Element angewendet werden soll
renderMode
Der Typ des Renderingmodus des Elements. Mögliche Werte sind: SOURCE (Standard), MASK oder ALL.
tintColor
Wenden Sie einen Farbfilter auf das Element an. Sie müssen die Farbe im ARGB-Format (#ff000000 = opakes Schwarz) oder RGB-Format (#000000 = Schwarz) angeben.

Innere Elemente

Das PartText-Element kann die folgenden Elemente im Inneren enthalten. Alle Elemente sind optional, mit der Ausnahme, dass entweder Text oder TextCircular eines der inneren Elemente sein muss. Ein PartText-Element kann eine unbegrenzte Anzahl jedes inneren Elements enthalten – mit Ausnahme von Text, TextCircular, Localization, Gyro, Launch und ScreenReader, die jeweils maximal einmal vorkommen dürfen.