PartText

Representa a parte de um mostrador do relógio que contém exatamente um elemento de layout de texto.

Introduzido no Wear OS 4.

Sintaxe

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

Atributos

O elemento PartText tem os seguintes atributos:

Atributos obrigatórios

Os seguintes atributos são obrigatórios:

x, y, width, height
Uma coleção de números inteiros que especifica o tamanho e a posição do elemento.

Atributos opcionais

Os seguintes atributos são opcionais:

pivotX, pivotY
Um eixo bidimensional em torno do qual o elemento gira. Os dois valores são números de ponto flutuante dimensionados para caber no intervalo $ [0, 1] $.
angle
Um número de graus, no sentido horário, em que o elemento precisa ser girado em torno do eixo.
alpha
Define o nível de transparência que esse elemento precisa ter. Um valor de 0 indica que o elemento precisa ser totalmente transparente. Um valor de 255 indica que o elemento precisa ser completamente opaco.
name
Uma string que identifica esse elemento. Útil se você precisar referenciar esse elemento em outro local no arquivo do mostrador do relógio.
scaleX
O fator de escalonamento horizontal a ser aplicado a esse elemento.
scaleY
O fator de escalonamento vertical a ser aplicado a esse elemento.
renderMode
O tipo de modo de renderização do elemento. Os valores possíveis são: SOURCE (padrão), MASK ou ALL.
tintColor
Aplica um filtro de cor matiz ao elemento. É preciso especificar a cor usando o formato ARGB (#ff000000 = preto opaco) ou RGB (#000000 = preto).

Elementos internos

O elemento PartText pode conter os seguintes elementos internos. Todos os elementos são opcionais, mas Text ou TextCircular precisam ser um dos elementos internos. Um elemento PartText pode conter um número ilimitado de cada elemento interno, exceto Text, TextCircular, Localization, Gyro, Launch e ScreenReader, que podem aparecer no máximo uma vez cada.