Teiltext

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

Mit Wear OS 4 eingeführt.

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
Ein Wert in Grad im Uhrzeigersinn, um den das Element um seinen Drehpunkt gedreht werden soll.
alpha
Legen Sie die Transparenz für dieses Element fest. 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. Nützlich, wenn Sie von einer anderen Stelle in der Zifferblattdatei aus auf dieses Element verweisen müssen.
scaleX
Der horizontale Skalierungsfaktor, der auf dieses Element angewendet wird.
scaleY
Der vertikale Skalierungsfaktor, der auf dieses Element angewendet wird.
renderMode
Der Typ des Rendermodus des Elements. Mögliche Werte sind: SOURCE (Standard), MASK oder ALL.
tintColor
Färben Sie das Element mit einem Farbfilter aus. Sie müssen die Farbe entweder im ARGB-Format (#ff000000 = opaken Schwarz) oder im RGB-Format (#000000 = Schwarz) angeben.

Innere Elemente

Das PartText-Element kann die folgenden inneren Elemente enthalten. Alle Elemente sind optional, außer 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 höchstens einmal vorkommen können.