טקסט זמן

טקסט של שעה הוא מחרוזת בפורמט שמייצגת את השעה הנוכחית.

הוצגה ב-Wear OS 4.

תחביר

<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
נקודת ציר דו-ממדית שסביבה הרכיב מסתובב. שני הערכים הם מספרי נקודה צפה (floating-point) שמתאימים לטווח $ [0, 1] $.
angle
מספר המעלות, בכיוון השעון, שבהן צריך לסובב את האלמנט סביב ציר הצירים שלו.
alpha
הגדרת רמת השקיפות של הרכיב הזה. הערך 0 מציין שהרכיב צריך להיות שקוף לחלוטין. הערך 255 מציין שהרכיב צריך להיות אטום לחלוטין.
tintColor
החלת מסנן גוון צבע על הרכיב. צריך לציין את הצבע באמצעות פורמט ARGB‏ (#ff000000 = שחור אטום) או פורמט RGB‏ (#000000 = שחור).

רכיבים פנימיים

הרכיב TimeText יכול להכיל את הרכיבים הפנימיים הבאים:

Variant
מאפשר לשנות את המאפיינים של האלמנט הזה כשמכשיר Wear OS נמצא במצב אווירה. מידע נוסף זמין במסמך העזרה של Variant.
BitmapFont
BitmapFont לשימוש ברינדור הזמן.
Font
גופן לשימוש ברינדור השעה.