جزء النص

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

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

بناء الجملة

<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 والتي يمكن أن تظهر مرة واحدة لكل عنصر.