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.
These attributes are transformable.
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] $.
These attributes are transformable.
angle
A number of degrees, clockwise, that the element should be rotated about its pivot point.
This attribute is transformable.
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.This attribute is transformable.
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.
This attribute is transformable.
scaleY
The vertical scaling factor to apply to this element.
This attribute is transformable.
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.