PartText

Representa la parte de una cara de reloj que contiene exactamente un elemento de diseño de texto.

Se introdujo en Wear OS 4.

Sintaxis

<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

El elemento PartText tiene los siguientes atributos:

Atributos obligatorios

Se requieren los siguientes atributos:

x, y, width y height

Es una colección de números enteros que especifican el tamaño y la posición del elemento.

Estos atributos son transformables.

Atributos opcionales

Los siguientes atributos son opcionales:

pivotX y pivotY

Es un punto de pivote bidimensional sobre el que rota el elemento. Ambos valores son números de punto flotante que se ajustan para adaptarse al rango $ [0, 1] $.

Estos atributos son transformables.

angle

Es la cantidad de grados, en el sentido de las manecillas del reloj, que el elemento debe rotar sobre su punto de pivote.

Este atributo es transformable.

alpha

Establece el nivel de transparencia que debe tener este elemento. Un valor de 0 indica que el elemento debe ser completamente transparente. Un valor de 255 indica que el elemento debe ser completamente opaco.

Este atributo es transformable.

name

Es una cadena que identifica este elemento. Es útil si necesitas hacer referencia a este elemento desde otra ubicación en el archivo de cara de reloj.

scaleX

Es el factor de escala horizontal que se aplica a este elemento.

Este atributo es transformable.

scaleY

El factor de escala vertical que se aplica a este elemento.

Este atributo es transformable.

renderMode

Es el tipo de modo de renderización del elemento. Los valores posibles son SOURCE (predeterminado), MASK o ALL.

tintColor

Aplica un filtro de color de tono al elemento. Debes especificar el color con el formato ARGB (#ff000000 = negro opaco) o el formato RGB (#000000 = negro).

Elementos internos

El elemento PartText puede contener los siguientes elementos internos: Todos los elementos son opcionales, excepto que Text o TextCircular deben ser uno de los elementos internos. Un elemento PartText puede contener un número ilimitado de cada elemento interno, excepto Text, TextCircular, Localization, Gyro, Launch y ScreenReader, que pueden aparecer 1 vez como máximo.