نص الوقت

نص الوقت هو سلسلة منسقة تمثل الوقت الحالي.

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

بناء الجملة

<TimeText format="string" hourFormat="12 | 24 | SYNC_TO_DEVICE"
             align="START | CENTER | END" x="integer" y="integer"
             width="integer" height="integer" pivotX="float" pivotY="float"
             angle="float-degrees" alpha="integer"
             tintColor="argb-color | rgb-color" />

السمات

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

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

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

format

سلسلة تنسيق تمثل تنسيق الوقت

تتضمّن هذه القائمة عدّة تنسيقات مختلفة لعرض الوقت في الساعة 12:34:56 بعد الظهر:

  • يتم عرض "hh:mm:ss" على النحو التالي: "12:34:56".
  • يتم عرض "h:mm" بالشكل "12:34".
  • يتم عرض العمود "hh_10" على النحو التالي: "1".
  • يتم عرض hh_1 على النحو التالي: "2".
  • يتم عرض m بالشكل "34".
  • يتم عرض العمود "mm_10" بالشكل "3".
  • يتم عرض mm_1 على النحو التالي: "4".
  • يتم عرض ss بالشكل "56".
  • يتم عرض ss_10 بالشكل "5".
  • يتم عرض ss_1 على النحو التالي: "6".
x وy وwidth وheight

مجموعة من الأعداد الصحيحة التي تحدد حجم العنصر وموضعه.

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

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

hourFormat
ما إذا كنت تريد استخدام ترميز 12 أو 24 ساعة لعرض الوقت. يتم ضبط الإعداد التلقائي على SYNC_TO_DEVICE، الذي يطبِّق الإعدادات المفضّلة للمستخدم التي تم ضبطها على الجهاز.
align:
كيفية محاذاة النص داخل مربّع الإحاطة يكون الإعداد التلقائي هو "START".
pivotX، pivotY
نقطة محورية ثنائية الأبعاد يدور حولها العنصر. كلتا القيمتين هما أرقام نقطة عائمة يتم تحجيمها لتلائم النطاق $ [0، 1] $.
angle
عدد الدرجات التي يجب تدوير العنصر بواسطة محوره المحوري، في اتجاه عقارب الساعة.
alpha
يمكنك ضبط مستوى الشفافية الذي يجب أن يوفّره هذا العنصر. تشير قيمة 0 إلى أن العنصر يجب أن يكون شفافًا تمامًا. تشير قيمة 255 إلى أن العنصر يجب أن يكون معتمًا تمامًا.
tintColor
تطبيق فلتر لون خفيف على العنصر وعليك تحديد اللون إمّا باستخدام تنسيق ARGB (#ff000000 = أسود معتم) أو تنسيق RGB (#000000 = أسود).

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

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

Variant
تتيح لك هذه السياسة تغيير سمات هذا العنصر عندما يكون جهاز Wear OS في الوضع المحيط. يمكنك الاطّلاع على مزيد من المعلومات في المرجع Variant.
BitmapFont
BitmapFont لاستخدامه في عرض الوقت.
Font
خط لاستخدامه في عرض الوقت.