جزء النص

تُمثل ذلك الجزء من خلفية شاشة الساعة الذي يحتوي على عنصر تصميم نصي واحد فقط.

تم طرحها في الإصدار 4 من نظام التشغيل Wear OS.

بناء الجملة

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

السمات

يحتوي عنصر PartText على السمات التالية:

السمات المطلوبة

يجب إرسال السمات التالية:

x، y، width، height

يشير ذلك المصطلح إلى مجموعة من الأعداد الصحيحة التي تحدّد حجم العنصر وموضعه.

هذه السمات قابلة للتحويل.

السمات الاختيارية

السمات التالية اختيارية:

pivotX، pivotY

نقطة محور ثنائية الأبعاد يدور حولها العنصر كلا القيمتين هما أعداد عشرية تم توسيع نطاقها لتلائم النطاق $ [0, 1] $.

هذه السمات قابلة للتحويل.

angle

عدد درجات في اتجاه عقارب الساعة يجب أن يتم تدوير العنصر حول نقطة محوره

هذه السمة قابلة للتحويل.

alpha

اضبط مستوى الشفافية الذي يجب أن يتميّز به هذا العنصر. تشير قيمة 0 إلى أن العنصر يجب أن يكون شفافًا تمامًا. تشير قيمة 255 إلى أن العنصر يجب أن يكون معتمًا تمامًا.

هذه السمة قابلة للتحويل.

name

سلسلة تتعرف على هذا العنصر. يكون ذلك مفيدًا إذا كنت بحاجة إلى الرجوع إلى هذا العنصر من مكان آخر داخل ملف خلفية شاشة الساعة.

scaleX

عامل التحجيم الأفقي المطلوب تطبيقه على هذا العنصر

هذه السمة قابلة للتحويل.

scaleY

عامل التكبير/التصغير العمودي الذي سيتم تطبيقه على هذا العنصر.

هذه السمة قابلة للتحويل.

renderMode

نوع وضع عرض العنصر القيم المحتمَلة هي: SOURCE (التلقائية)، MASK أو ALL.

tintColor

طبِّق فلترًا لدرجات اللون على العنصر. يجب تحديد اللون باستخدام إما تنسيق ARGB (#ff000000 = أسود غير شفاف) أو تنسيق RGB (#000000 = أسود).

العناصر الداخلية

يمكن أن يحتوي العنصر PartText على العناصر الداخلية التالية. جميع العناصر اختيارية، باستثناء Text أو TextCircular التي يجب أن تكون أحد العناصر الداخلية. يمكن أن يحتوي عنصر PartText على عدد غير محدود من العناصر الداخلية، باستثناء العناصر Text وTextCircular وLocalization وGyro وLaunch وScreenReader والتي يمكن أن تظهر مرة واحدة لكل عنصر.