PartText

Merepresentasikan bagian tampilan jam yang berisi tepat satu elemen tata letak teks.

Diperkenalkan di Wear OS 4.

Sintaksis

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

Atribut

Elemen PartText memiliki atribut berikut:

Atribut wajib

Atribut berikut wajib diisi:

x, y, width, height

Kumpulan bilangan bulat yang menentukan ukuran dan posisi elemen.

Atribut ini dapat ditransformasi.

Atribut opsional

Atribut berikut bersifat opsional:

pivotX, pivotY

Titik pivot dua dimensi, tempat elemen berputar. Kedua nilai tersebut adalah bilangan floating point yang diskalakan agar sesuai dengan rentang $ [0, 1] $.

Atribut ini dapat diubah.

angle

Beberapa derajat, searah jarum jam, saat elemen harus diputar di sekitar titik pivotnya.

Atribut ini dapat diubah.

alpha

Tetapkan tingkat transparansi yang harus dimiliki elemen ini. Nilai 0 menunjukkan bahwa elemen tersebut harus sepenuhnya transparan. Nilai 255 menunjukkan bahwa elemen harus benar-benar buram.

Atribut ini dapat diubah.

name

String yang mengidentifikasi elemen ini. Berguna jika Anda perlu merujuk ke elemen ini dari lokasi lain dalam file tampilan jam.

scaleX

Faktor penskalaan horizontal yang akan diterapkan ke elemen ini.

Atribut ini dapat diubah.

scaleY

Faktor penskalaan vertikal yang akan diterapkan ke elemen ini.

Atribut ini dapat diubah.

renderMode

Jenis mode render elemen. Nilai yang mungkin adalah: SOURCE (default), MASK, atau ALL.

tintColor

Terapkan filter warna tint ke elemen. Anda harus menentukan warna menggunakan format ARGB (#ff000000 = hitam buram) atau format RGB (#000000 = hitam).

Elemen bagian dalam

Elemen PartText dapat berisi elemen bagian dalam berikut. Semua elemen bersifat opsional, kecuali Text atau TextCircular harus berupa salah satu elemen bagian dalam. Elemen PartText dapat berisi jumlah yang tidak terbatas dari setiap elemen dalam -- kecuali untuk Text, TextCircular, Localization, Gyro, Launch, dan ScreenReader, yang masing-masing dapat muncul maksimal 1 kali.