表示仅包含一个文本布局元素的表盘部分。
此元素在 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
- 表示元素围绕其旋转的二维轴心点。这两个值都是浮点数,且均会经过调整以符合 $ [0, 1] $ 这一范围。
angle
- 表示元素围绕轴心点顺时针旋转时应遵循的角度值。
alpha
- 用于设置此元素应具有的透明度。值
0
表示此元素应是完全透明的。值255
表示此元素应是完全不透明的。 name
- 用于标识此元素的字符串。如果您需要从表盘文件中的其他位置引用此元素,则该字符串会非常有用。
scaleX
- 表示要应用于此元素的横向缩放比例。
scaleY
- 表示要应用于此元素的纵向缩放比例。
renderMode
- 表示此元素的渲染模式类型。可能的值包括
SOURCE
(默认)、MASK
或ALL
。 tintColor
- 对此元素应用色调滤镜。您必须使用 ARGB 格式(
#ff000000
= 不透明的黑色)或 RGB 格式(#000000
= 黑色)来指定颜色。
内部元素
PartText
元素可以包含以下内部元素。所有这些元素都是可选的,但 Text
或 TextCircular
必须是内部元素之一。除了 Text
、TextCircular
、Localization
、Gyro
、Launch
和 ScreenReader
最多分别只能出现 1 次外,其他每个内部元素在 PartText
元素中的使用次数不受限制。