טקסט עגול

קובעת תצורה של טקסט עגול או מעוגל.

הוצגה ב-Wear OS 4.

תחביר

<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

זוג ערכים של נקודה צפה (floating-point) שמציינים את גודל הרכיב.

startAngle וגם endAngle

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

לדוגמה, כדי לטשטש טקסט סביב הרבע העליון של תצוגת השעון, משתמשים ב-startAngle של 335.0 וב-endAngle של 45.0.

אפשר לשנות את המאפיינים האלה.

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

המאפיינים הבאים הם אופציונליים:

direction

מציין את הכיוון של הטקסט:

  • CLOCKWISE (ברירת המחדל): הצגת הטקסט בכיוון השעון.
  • COUNTER_CLOCKWISE: הצגת הטקסט בכיוון נגד כיוון השעון.
align

קובע את היישור של הטקסט בתוך רכיב ההורה שלו:

  • START: ממורכז בצד ימין או בחלק העליון (ממורכז בצד ימין כשהשפה הנוכחית משתמשת בכיוון טקסט RTL)
  • CENTER: מיושר למרכז
  • END: מימין או בתחתית (בצד ימין כשהשפה הנוכחית היא שפה עם כיוון טקסט מימין לשמאל)

ערך ברירת המחדל הוא CENTER.

ellipsis

ערך בוליאני שמציין אם להציג שלוש נקודות אם הטקסט ארוך מדי מכדי להתאים לאלמנט ההורה. ערך ברירת המחדל הוא FALSE.

אלמנטים פנימיים

הרכיב Text יכול להכיל מספר בלתי מוגבל של הרכיבים הפנימיים הבאים: