Teiltext

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

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

Diese Attribute können transformiert werden.

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 in den Bereich $ [0, 1] $ passen.

Diese Attribute sind transformierbar.

angle

Die Anzahl der Grad, um die das Element im Uhrzeigersinn um seinen Drehpunkt gedreht werden soll.

Dieses Attribut kann transformiert werden.

alpha

Legen Sie die Transparenz dieses Elements fest. Der Wert 0 gibt an, dass das Element vollständig transparent sein soll. Der Wert 255 gibt an, dass das Element vollständig undurchsichtig sein soll.

Dieses Attribut kann transformiert werden.

name

Ein String, der dieses Element identifiziert. Nützlich, wenn Sie dieses Element an einer anderen Stelle in der Zifferblattdatei referenzieren müssen.

scaleX

Der horizontale Skalierungsfaktor, der auf dieses Element angewendet werden soll.

Dieses Attribut kann transformiert werden.

scaleY

Der vertikale Skalierungsfaktor, der auf dieses Element angewendet wird.

Dieses Attribut ist transformierbar.

renderMode

Der Typ des Rendermodus des Elements Mögliche Werte sind SOURCE (Standard), MASK oder ALL.

tintColor

Wenden Sie einen Farbtonfilter auf das Element an. Sie müssen die Farbe entweder im ARGB-Format (#ff000000 = opakes 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.