Represents the part of a watch face that contains exactly one text layout element.
Introduced in Wear OS 4.
Syntax
<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>
Attributes
The PartText
element has the following attributes:
Required attributes
The following attributes are required:
x
,y
,width
,height
- A collection of integers that specify the element's size and position.
Optional attributes
The following attributes are optional:
pivotX
,pivotY
- A two-dimensional pivot point about which the element rotates. Both values are floating-point numbers that are scaled to fit in the range $ [0, 1] $.
angle
- A number of degrees, clockwise, that the element should be rotated about its pivot point.
alpha
- Set the level of transparency that this element should have. A value of
0
indicates that the element should be completely transparent. A value of255
indicates that the element should be completely opaque. name
- A string that identifies this element. Useful if you need to refer to this element from another location within your watch face file.
scaleX
- The horizontal scaling factor to apply to this element.
scaleY
- The vertical scaling factor to apply to this element.
renderMode
- The element's render mode type. Possible values are:
SOURCE
(default),MASK
, orALL
. tintColor
- Apply a tint color filter to the element. You must specify the color using
either the ARGB format (
#ff000000
= opaque black) or the RGB format (#000000
= black).
Inner elements
The PartText
element can contain the following inner elements. All elements
are optional, except that either Text
or TextCircular
must be one of the
inner elements. A PartText
element can contain an unlimited number of each
inner element -- except for Text
, TextCircular
, Localization
, Gyro
,
Launch
, and ScreenReader
, which can appear at most 1 time each.