שעון דיגיטלי

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

הוצגה ב-Wear OS 4.

תחביר

<DigitalClock x="integer" y="integer" width="integer" height="integer"
             pivotX="float" pivotY="float" angle="float-degrees" alpha="integer"
             scaleX="float" scaleY="float"
             renderMode="[SOURCE | MASK | ALL]"
             tintColor="argb-color | rgb-color">
    <!-- This is the only required inner element. -->
    <TimeText ... />
</DigitalClock>

מאפיינים

לרכיב DigitalClock יש את המאפיינים הבאים:

מאפיינים נדרשים

המאפיינים הבאים הם מאפייני חובה:

x, y, width, height

מאפיינים אופציונליים

המאפיינים הבאים הם אופציונליים:
אוסף של מספרים שלמים שמציינים את הגודל והמיקום של האלמנט.
pivotX, pivotY
נקודת ציר דו-ממדית שסביבה הרכיב מסתובב. שני הערכים הם מספרי נקודה צפה (floating-point) שמתאימים לטווח $ [0, 1] $.
angle
מספר המעלות, בכיוון השעון, שבהן צריך לסובב את האלמנט סביב ציר הצירים שלו.
alpha
הגדרת רמת השקיפות של הרכיב הזה. הערך 0 מציין שהרכיב צריך להיות שקוף לחלוטין. הערך 255 מציין שהרכיב צריך להיות אטום לחלוטין.
scaleX
גורם לקביעת קנה מידה אופקי שחלה על הרכיב הזה.
scaleY
גורם לקביעת קנה מידה אנכי שיש להחיל על הרכיב הזה.
renderMode
סוג מצב הרינדור של הרכיב. הערכים האפשריים הם: SOURCE (ברירת המחדל), MASK או ALL.
tintColor
החלת מסנן גוון צבע על הרכיב. צריך לציין את הצבע באמצעות פורמט ARGB‏ (#ff000000 = שחור אטום) או פורמט RGB‏ (#000000 = שחור).

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

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

TimeText

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

Localization
מספק רמז לגבי הלוקאל שבו יש להשתמש כשמייצרים את השעה. מידע נוסף זמין במסמך העזרה של Localization.

רכיב DigitalClock יכול להכיל רכיב Localization אחד לכל היותר.

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