复杂功能边界区域

复杂功能边界区域用于定义复杂功能的呈现区域。表盘编辑器中会显示边界区域的轮廓。边界区域以外的所有内容都会被剪裁。

边界区域还决定了用户可以在表盘上选择复杂功能的区域。

此元素在 Wear OS 4 中推出。

BoundingBox

BoundingBox 元素用于定义复杂功能的矩形边界区域。

语法

<BoundingBox x="integer" y="integer" width="integer" height="integer"
                outlinePadding="float" />

属性

BoundingBox 元素具有以下属性:

必需属性

以下属性是必需属性:

xywidthheight
用于指定元素的大小和位置的整数集合。

可选属性

以下属性是可选属性:

outlinePadding
一个浮点数,用于指定要应用到边界区域外部的内边距。此属性用于在表盘编辑器中创建更大的轮廓。默认设置为 0。

BoundingRoundBox

BoundingRoundBox 元素用于定义复杂功能的圆角矩形边界区域。

语法

<BoundingRoundBox x="integer" y="integer" width="integer" height="integer"
                outlinePadding="float" cornerRadius="float" />

属性

BoundingRoundBox 元素具有以下属性:

必需属性

以下属性是必需属性:

xywidthheight
用于指定元素的大小和位置的整数集合。

可选属性

以下属性是可选属性:

cornerRadius

圆形的半径。此值用于指定矩形的角的圆度。

outlinePadding
一个浮点数,用于指定要应用到边界区域外部的内边距。此属性用于在表盘编辑器中创建更大的轮廓。默认设置为 0。

BoundingOval

BoundingOval 元素用于定义复杂功能的圆形边界区域。

语法

<BoundingOval x="integer" y="integer" width="integer" height="integer"
                outlinePadding="float" />

属性

BoundingOval 元素具有以下属性:

必需属性

以下属性是必需属性:

xywidthheight
用于指定元素的大小和位置的整数集合。

可选属性

以下属性是可选属性:

outlinePadding
一个浮点数,用于指定要应用到边界区域外部的内边距。此属性用于在表盘编辑器中创建更大的轮廓。默认设置为 0。

BoundingArc

BoundingArc 元素用于定义复杂功能的弧形边界区域。

语法

<BoundingArc centerX="float" centerY="float" width="float"
                height="float" thickness="float" isRoundEdge="boolean"
                startAngle="float" endAngle="float"
                direction="CLOCKWISE | COUNTER_CLOCKWISE"
                outlinePadding="float" />

属性

BoundingArc 元素具有以下属性:

必需属性

以下属性是必需属性:

centerXcenterYwidthheight
表示一系列属性,用于定义弧形的衍生椭圆形。系统会对弧形进行调整以适应指定的椭圆形。所有属性均定义为浮点数。
thickness
弧形的粗细,以浮点数表示。
startAngle
弧形起点的起始角度(以度为单位)。角度为 0 对应于手表上的 12 点位置。
endAngle
弧形终点的结束角度。

可选属性

以下属性是可选属性:

isRoundEdge
用于确定弧形末尾的顶端是平的还是圆的。默认设置为 FALSE。
direction
弧形的旋转方向。默认设置为 CLOCKWISE
outlinePadding
一个浮点数,用于指定要应用到边界区域外部的内边距。此属性用于在表盘编辑器中创建更大的轮廓。默认设置为 0。