加权笔触

自版本 2 起

一种具有单独段的笔触模式，可以采用指定的权重和颜色。特别适用于渲染 GOAL_PROGRESS、RANGED_VALUE 和 WEIGHTED_ELEMENTS 并发症。

语法

<WeightedStroke colors="argb-color-list" thickness="float"
    weights="weight-list" discreteGap="float" interpolate="boolean"
    cap="BUTT | ROUND | SQUARE" />

属性

WeightedStroke 元素具有以下属性

必需属性

以下属性是必需的

颜色

加权笔触的每个元素的颜色，以空格分隔的十六进制值列表表示，例如：#FF0000 #00FF00 #0000FF。

当用于渲染提供颜色数据的 GOAL_PROGRESS 或 RANGED_VALUE 并发症数据，或者与 WEIGHTED_ELEMENTS 一起使用时，colors 可以直接用 [COMPLICATION.GOAL_PROGRESS_COLORS]、[COMPLICATION.RANGED_VALUE_COLORS] 或 [COMPLICATION.WEIGHTED_ELEMENTS_COLORS] 填充。

厚度

笔触的厚度，以 浮点尺寸 表示。

可选属性

以下属性是可选的

权重

一个空格分隔的值列表，它决定每个权重占用的弧度比例，例如 1.0 2.0 3.0，其中第三个元素占据第一个元素角度的 3 倍。

当用于表示 WEIGHTED_ELEMENTS 并发症的数据时，可以将 [COMPLICATION.WEIGHTED_ELEMENTS_WEIGHTS] 直接传入。

离散间隙

每个元素之间的角度。默认为 0.0。

插值

当设置为 true 时，weights 列表中的每个元素 N 都有一个从 colors 列表中的颜色 N 到颜色 N+1 的颜色渐变，而不是纯色。

当用于表示 GOAL_PROGRESS 或 RANGED_VALUE 并发症的数据时，可以将 [COMPLICATION.GOAL_PROGRESS_COLORS_INTERPOLATE] 或 [COMPLICATION.RANGED_VALUE_COLORS_INTERPOLATE] 字段的值直接传入。当用于表示 WEIGHTED_ELEMENTS 并发症数据时，将 interpolate 设置为 false。

默认为 false。

帽子

确定笔触边缘的形状。支持的值为

• BUTT 使笔触以路径结束，而不是超出路径。
• ROUND 使笔触以半圆形突出，中心位于路径的末端。
• SQUARE 使笔触以正方形突出，中心位于路径的末端。

内部元素

WeightedStroke 元素可以包含以下元素

• 变换