جزء النص

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

تم طرح هذه الميزة في 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، والتي يمكن أن تظهر مرة واحدة على الأكثر لكل عنصر.