מייצג את החלק בתצוגת השעון שמכיל רכיב אחד בלבד של פריסת טקסט.
התכונה הושקה ב-Wear OS 4.
תחביר
<PartText x="integer" y="integer" width="integer" height="integer" pivotX="float" pivotY="float" angle="float-degrees" alpha="integer" name="string" scaleX="float" scaleY="float" renderMode="[SOURCE | MASK | ALL]" tintColor="argb-color | rgb-color"> <!-- Text-specific child elements. --> <Text> <!-- There must be raw text as the leaf inner element within a "PartText" element tree. --> <Font family="font" size="20" color="#00FFFF">Hello world </Font> <Font> <!-- Example of a text decoration element. --> <Outline> <!-- Example of a template with 2 string values. --> <Template>%s %s <Parameter expression="[MONTH_S]" /> <Parameter expression="[DAY]" /> </Template> </Outline> <!-- Example of a text formatting element. --> <Upper> <Template ... /> </Upper> <Template ... /> </Font> </Text> <!-- A "PartText" element can contain this "TextCircular" element instead of a "Text" element. --> <TextCircular centerX="180" centerY="180" direction="COUNTER_CLOCKWISE" endAngle="90" height="340" width="340" startAngle="270"> <!-- There must be raw text as the leaf inner element within a "PartText" element tree. --> <Font family="font" size="20" color="#00FFFF">Hello world </Font> <Font> Example of a text decoration element. <Outline> Example of a template with 2 string values. <Template>%s %s <Parameter expression="[MONTH_S]" /> <Parameter expression="[DAY]" /> </Template> </Outline> Example of a text formatting element. <Upper> <Template ... /> </Upper> <Template ... /> </Font> </TextCircular /> --> <!-- Child elements that are shared across all "Part" elements. --> <Localization .../> <Transform .../> <Variant .../> <Gyro .../> <Launch .../> <ScreenReader .../> </PartText>
מאפיינים
הרכיב PartText
כולל את המאפיינים הבאים:
מאפיינים נדרשים
חובה לציין את המאפיינים הבאים:
x
,y
,width
,height
אוסף של מספרים שלמים שמציינים את המיקום והגודל של הרכיב.
המאפיינים האלה ניתנים להמרה.
מאפיינים אופציונליים
המאפיינים הבאים הם אופציונליים:
pivotX
,pivotY
נקודת ציר דו-ממדית שסביבה הרכיב מסתובב. שני הערכים הם מספרים מנקודה צפה (floating-point) שמדורגת כדי להתאים לטווח של $ [0, 1] $.
אפשר לשנות את המאפיינים האלה.
angle
מספר המעלות, בכיוון השעון, שבהן צריך לסובב את הרכיב סביב ציר הצירים שלו.
המאפיין הזה ניתן לטרנספורמציה.
alpha
הגדרת רמת השקיפות של הרכיב הזה. הערך
0
מציין שהאלמנט צריך להיות שקוף לחלוטין. הערך255
מציין שהאלמנט צריך להיות אטום לחלוטין.המאפיין הזה ניתן לטרנספורמציה.
name
מחרוזת שמזהה את הרכיב הזה. כדאי להשתמש ברכיב הזה אם אתם צריכים להתייחס לרכיב הזה ממיקום אחר בקובץ של תצוגת השעון.
scaleX
גורם קנה המידה האופקי שצריך להחיל על הרכיב הזה.
המאפיין הזה ניתן לשינוי.
scaleY
גורם קנה המידה האנכי שיש להחיל על הרכיב הזה.
המאפיין הזה ניתן לשינוי.
renderMode
סוג מצב העיבוד של הרכיב. הערכים האפשריים הם:
SOURCE
(ברירת המחדל),MASK
אוALL
.tintColor
מחילים על הרכיב מסנן גוון צבע. צריך לציין את הצבע באמצעות פורמט ARGB (
#ff000000
= שחור אטום) או פורמט RGB (#000000
= שחור).
אלמנטים פנימיים
הרכיב PartText
יכול להכיל את הרכיבים הפנימיים הבאים. כל הרכיבים הם אופציונליים, מלבד אלה ש-Text
או TextCircular
חייבים להיות אחד מהאלמנטים הפנימיים. רכיב PartText
יכול להכיל מספר בלתי מוגבל של כל רכיב פנימי, מלבד Text
, TextCircular
, Localization
, Gyro
, Launch
ו-ScreenReader
, שיכולים להופיע בכל פעם רק פעם אחת.