دائري نصي

تُحدِّد إعدادات نص دائري أو منحني.

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

بناء الجملة

<TextCircular centerX="float" centerY="float"
              direction="CLOCKWISE | COUNTER_CLOCKWISE" width="float"
              height="float" startAngle="float-degrees"
              endAngle="float-degrees" align="START | CENTER | END"
              ellipsis="boolean" >
    <!-- Possible inner elements. The PartText element syntax shows a
         more complete example. -->
    <Transform .../>
    <Font ... />
    <BitmapFont ... />
</TextCircular>

السمات

يحتوي عنصر TextCircular على السمات التالية. بعض السمات مطلوبة في حين أن البعض الآخر اختيارية.

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

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

centerX وcenterY

يشير ذلك المصطلح إلى زوج من قيم النقطة العائمة التي تحدِّد موضع مركز العنصر.

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

width وheight

زوج من قيم الكسور العشرية التي تحدّد حجم العنصر

startAngle وendAngle

زوج من قيم النقطة العائمة التي تحدد زاوية بداية النص وزاوية جانب نهاية النص على التوالي. تمثّل الزاوية 0 درجة موضع الساعة 12 على خلفية شاشة الساعة.

على سبيل المثال، لقوس النص حول الربع العلوي من خلفية شاشة الساعة، استخدِم startAngle من 335.0 وendAngle للرمز 45.0.

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

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

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

direction

يشير إلى اتجاه كتابة النص:

• CLOCKWISE (تلقائي): عرض النص في اتجاه عقارب الساعة
• COUNTER_CLOCKWISE: عرض النص في عكس عقارب الساعة

align

لتحديد محاذاة النص ضمن العنصر الرئيسي:

• START: محاذاة إلى اليسار أو أعلى (تمت محاذاته لليمين عندما تستخدم اللغة الحالية اتجاه النص من اليمين إلى اليسار)
• CENTER: محاذاة في الوسط
• END: محاذاة لليمين أو الأسفل (تمت المحاذاة إلى اليسار عندما تستخدم اللغة الحالية اتجاه النص من اليمين إلى اليسار)

تكون القيمة التلقائية CENTER.

ellipsis

قيمة منطقية تشير إلى ما إذا كان سيتم عرض علامة شرطة منقطة إذا كان النص طويلاً جدًا بحيث لا يناسب العنصر الرئيسي. القيمة التلقائية هي FALSE.

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

يمكن أن يحتوي العنصر Text على أي عدد من العناصر الداخلية التالية:

• Transform
• Font
• BitmapFont