PartText

Représente la partie d'un cadran ne contenant qu'un seul élément de mise en page de texte.

Introduit dans Wear OS 4.

Syntaxe

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

Attributs

L'élément PartText comporte les attributs suivants :

Attributs obligatoires

Les attributs suivants sont obligatoires :

x, y, width, height

Ensemble d'entiers qui spécifient la taille et la position de l'élément.

Ces attributs sont transformables.

Attributs facultatifs

Les attributs suivants sont facultatifs :

pivotX, pivotY

Point pivot bidimensionnel autour duquel l'élément pivote. Les deux valeurs sont des nombres à virgule flottante qui sont ajustés pour tenir dans la plage $ [0, 1] $.

Ces attributs sont transformables.

angle

Un certain nombre de degrés de rotation de l'élément autour de son point pivot (dans le sens des aiguilles d'une montre).

Cet attribut est transformable.

alpha

Définissez le niveau de transparence à appliquer à cet élément. La valeur 0 indique que l'élément doit être totalement transparent. La valeur 255 indique que l'élément doit être complètement opaque.

Cet attribut est transformable.

name

Chaîne qui identifie cet élément. Cette option est utile si vous devez vous référer à cet élément depuis un autre emplacement du fichier de votre cadran.

scaleX

Facteur de scaling horizontal à appliquer à cet élément.

Cet attribut est transformable.

scaleY

Facteur de scaling vertical à appliquer à cet élément.

Cet attribut est transformable.

renderMode

Type de mode de rendu de l'élément. Les valeurs possibles sont SOURCE (par défaut), MASK ou ALL.

tintColor

Appliquez un filtre de couleur (teinte) à l'élément. Vous devez spécifier la couleur au format ARVB (#ff000000 = noir opaque) ou au format RVB (#000000 = noir).

Éléments internes

L'élément PartText peut contenir les éléments internes suivants. Tous les éléments sont facultatifs, mais Text ou TextCircular doit être l'un des éléments internes. Un élément PartText peut contenir un nombre illimité d'éléments internes de chaque type, à l'exception de Text, TextCircular, Localization, Gyro, Launch et ScreenReader, qui ne peuvent apparaître qu'une seule fois.