PartText

Reprezentuje część tarczy zegarka, która zawiera dokładnie 1 element układu tekstu.

Wprowadzone w Wear OS 4.

Składnia

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

Atrybuty

Element PartText ma te atrybuty:

Atrybuty wymagane

Wymagane są te atrybuty:

x, y, width, height

Zbiór liczb całkowitych, które określają rozmiar i pozycję elementu.

Te atrybuty można przekształcać.

Atrybuty opcjonalne

Te atrybuty są opcjonalne:

pivotX, pivotY

Dwuwymiarowy punkt obrotu, wokół którego obraca się element. Obie wartości są liczbami zmiennoprzecinkowymi, które są skalowane tak, aby mieścić się w zakresie $ [0, 1] $.

Te atrybuty można przekształcać.

angle

Liczba stopni, o którą element powinien zostać obrócony zgodnie z kierunkiem ruchu wskazówek zegara.

Ten atrybut można przekształcić.

alpha

Ustaw poziom przezroczystości tego elementu. Wartość 0 wskazuje, że element powinien być całkowicie przezroczysty. Wartość 255 wskazuje, że element powinien być całkowicie nieprzezroczysty.

Ten atrybut można przekształcić.

name

Ciąg znaków identyfikujący ten element. Przydatne, jeśli chcesz odwołać się do tego elementu z innego miejsca w pliku tarczy zegarka.

scaleX

Współczynnik skalowania poziomego, który ma być zastosowany do tego elementu.

Ten atrybut można przekształcić.

scaleY

Współczynnik skalowania w pionie, który ma być stosowany do tego elementu.

Ten atrybut można przekształcić.

renderMode

Typ trybu renderowania elementu. Możliwe wartości to SOURCE (domyślna), MASK oraz ALL.

tintColor

Stosuje do elementu filtr koloru zabarwienia. Kolor musisz określić w formacie ARGB (#ff000000 = czarny przezroczysty) lub RGB (#000000 = czarny).

Elementy wewnętrzne

Element PartText może zawierać te elementy wewnętrzne. Wszystkie elementy są opcjonalne, z tym że Text lub TextCircular musi być jednym z wewnętrznych elementów. Element PartText może zawierać nieograniczoną liczbę elementów wewnętrznych, z wyjątkiem elementów Text, TextCircular, Localization, Gyro, Launch i ScreenReader, które mogą pojawiać się maksymalnie raz.