טקסט חלק

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

התכונה הושקה ב-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, שיכולים להופיע בכל פעם רק פעם אחת.