Teiltext

Stellt den Teil eines Zifferblatts dar, der genau ein Textlayout enthält -Elements.

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>

Attribute

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 sind, dass sie im Bereich $ [0, 1] $ passen.
angle
Ein Wert in Grad im Uhrzeigersinn, um den das Element um seine Drehpunkt.
alpha
Legen Sie die Transparenz für dieses Element fest. Ein Wert von 0 gibt an, dass das Element vollständig transparent sein soll. Ein Wert von 255 gibt an, dass das Element vollständig deckend sein soll.
name
Ein String, der dieses Element identifiziert. Nützlich, wenn Sie sich darauf beziehen müssen an einer anderen Stelle in der Zifferblatt-Datei.
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 mit entweder im ARGB-Format (#ff000000 = opaken Schwarz) oder RGB (#000000 = Schwarz).

Innere Elemente

Das PartText-Element kann die folgenden inneren Elemente enthalten. Alle Elemente sind optional, außer dass entweder Text oder TextCircular einer der folgenden Werte sein muss: inneren Elementen. Ein PartText-Element kann jeweils eine unbegrenzte Anzahl von Elementen enthalten inneres Element – außer Text, TextCircular, Localization, Gyro Launch und ScreenReader, die jeweils höchstens einmal angezeigt werden können.