PartText

Đại diện cho một phần của mặt đồng hồ chứa chính xác một phần tử bố cục văn bản.

Ra mắt trong Wear OS 4.

Cú pháp

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

Thuộc tính

Phần tử PartText có các thuộc tính như sau:

Thuộc tính bắt buộc

Các thuộc tính sau đây là bắt buộc:

x, y, width, height

Tập hợp số nguyên chỉ định kích thước và vị trí của phần tử.

Các thuộc tính này có thể biến đổi.

Thuộc tính không bắt buộc

Các thuộc tính sau đây là không bắt buộc:

pivotX, pivotY

Điểm trung tâm hai chiều là điểm mà các phần tử xoay quanh. Cả hai đều là giá trị dấu phẩy động được điều chỉnh theo tỷ lệ để nằm trong khoảng $ [0, 1] $.

Các thuộc tính này có thể biến đổi.

angle

Số độ (theo chiều kim đồng hồ) mà phần tử phải xoay quanh điểm trung tâm.

Thuộc tính này có thể biến đổi.

alpha

Thiết lập mức độ trong suốt mà phần tử này cần có. Giá trị 0 cho biết phần tử phải hoàn toàn trong suốt. Giá trị 255 cho biết phần tử phải hoàn toàn mờ đục.

Thuộc tính này có thể biến đổi.

name

Một chuỗi dùng để xác định phần tử này. Hữu ích nếu bạn cần tham chiếu đến phần tử này từ một vị trí khác trong tệp mặt đồng hồ.

scaleX

Hệ số tỷ lệ ngang dùng để áp dụng cho phần tử này.

Thuộc tính này có thể biến đổi.

scaleY

Hệ số tỷ lệ dọc dùng để áp dụng cho phần tử này.

Thuộc tính này có thể biến đổi.

renderMode

Kiểu chế độ kết xuất của phần tử. Các giá trị có thể là: SOURCE (mặc định), MASK hoặc ALL.

tintColor

Áp dụng bộ lọc màu phủ màu cho phần tử. Bạn phải chỉ định màu bằng cách sử dụng định dạng ARGB (#ff000000 = màu đen tuyền) hoặc định dạng RGB (#000000 = màu đen).

Phần tử bên trong

Phần tử PartText có thể chứa các phần tử bên trong sau đây: Tất cả các phần tử đều không bắt buộc, ngoại trừ Text hoặc TextCircular phải là một trong các phần tử bên trong. Một phần tử PartText có thể chứa số phần tử bên trong không giới hạn, ngoại trừ phần tử Text, TextCircular, Localization, Gyro, LaunchScreenReader có thể xuất hiện nhiều nhất là 1 lần.