تُمثل ذلك الجزء من خلفية شاشة الساعة الذي يحتوي على عنصر تصميم نصي واحد فقط.
تم طرحها في الإصدار 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
والتي يمكن أن تظهر مرة واحدة لكل عنصر.