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.

Esses atributos são transformáveis.

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] $.

Esses atributos são transformáveis.

angle

Um número de graus, no sentido horário, em que o elemento precisa ser girado em torno do eixo.

Esse atributo é transformável.

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 totalmente opaco.

Esse atributo é transformável.

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.

Esse atributo é transformável.

scaleY

O fator de escalonamento vertical a ser aplicado a esse elemento.

Esse atributo é transformável.

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.