Testo parte

Rappresenta la parte di un quadrante che contiene esattamente un elemento di layout di testo.

Introdotta in Wear OS 4.

Sintassi

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

Attributi

L'elemento PartText ha i seguenti attributi:

Attributi obbligatori

I seguenti attributi sono obbligatori:

x, y, width, height
Una raccolta di numeri interi che specificano le dimensioni e la posizione dell'elemento.

Attributi facoltativi

I seguenti attributi sono facoltativi:

pivotX, pivotY
Un punto pivot bidimensionale rispetto al quale l'elemento ruota. Entrambi i valori sono numeri in virgola mobile che vengono ridimensionati per rientrare nell'intervallo $ [0, 1] $.
angle
Un numero di gradi, in senso orario, in cui l'elemento deve essere ruotato attorno al suo punto di pivot.
alpha
Imposta il livello di trasparenza che questo elemento deve avere. Il valore 0 indica che l'elemento deve essere completamente trasparente. Il valore 255 indica che l'elemento deve essere completamente opaco.
name
Una stringa che identifica questo elemento. Utile se devi fare riferimento a questo elemento da un'altra posizione nel file del quadrante.
scaleX
Il fattore di ridimensionamento orizzontale da applicare a questo elemento.
scaleY
Il fattore di ridimensionamento verticale da applicare a questo elemento.
renderMode
Il tipo di modalità di rendering dell'elemento. I valori possibili sono: SOURCE (predefinito), MASK o ALL.
tintColor
Applica all'elemento un filtro di colore di tinta. Devi specificare il colore utilizzando il formato ARGB (#ff000000 = nero opaco) o il formato RGB (#000000 = nero).

Elementi interni

L'elemento PartText può contenere i seguenti elementi interni. Tutti gli elementi sono facoltativi, tranne Text o TextCircular devono essere uno degli elementi interni. Un elemento PartText può contenere un numero illimitato di ogni elemento interno, ad eccezione di Text, TextCircular, Localization, Gyro, Launch e ScreenReader, che possono apparire al massimo una volta ciascuno.