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.

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] $.
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).
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.
name
Chaîne identifiant 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.
scaleY
Facteur de scaling vertical à appliquer à cet élément.
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.