Trait pondéré

Depuis la version 2

Motif de trait avec des segments individuels, qui peuvent avoir des épaisseurs et des couleurs spécifiques. Cette approche est particulièrement utile pour afficher les complications GOAL_PROGRESS, RANGED_VALUE et WEIGHTED_ELEMENTS.

Syntaxe

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

Attributs

L'élément WeightedStroke comporte les attributs suivants :

Attributs obligatoires

Les attributs suivants sont obligatoires :

colors

Couleurs de chaque élément du trait pondéré, sous forme de liste de valeurs hexadécimales séparées par un espace (par exemple, #FF0000 #00FF00 #0000FF).

Lorsqu'il est utilisé pour afficher des données de complication GOAL_PROGRESS ou RANGED_VALUE qui fournissent des données de couleur, ou avec WEIGHTED_ELEMENTS, colors peut être renseigné directement avec [COMPLICATION.GOAL_PROGRESS_COLORS], [COMPLICATION.RANGED_VALUE_COLORS] ou [COMPLICATION.WEIGHTED_ELEMENTS_COLORS].

thickness

Épaisseur du trait, exprimée en dimension flottante.

Attributs facultatifs

Les attributs suivants sont facultatifs :

weights

Liste de valeurs séparées par un espace, qui déterminent la proportion de l'arc absorbée par chaque pondération. Par exemple, 1.0 2.0 3.0, où le troisième élément occupe trois fois l'angle du premier élément.

Lorsqu'il est utilisé pour représenter les données de la complication WEIGHTED_ELEMENTS, le [COMPLICATION.WEIGHTED_ELEMENTS_WEIGHTS] peut être transmis directement.

discreteGap

Angle entre chaque élément. La valeur par défaut est 0.0.

interpolate

Lorsqu'il est défini sur true, chaque élément N de la liste weights comporte un dégradé de couleurs allant de la couleur N à la couleur N+1 de la liste colors, par opposition à une couleur unie.

Lorsque vous l'utilisez pour représenter des données de complications GOAL_PROGRESS ou RANGED_VALUE, vous pouvez transmettre directement les valeurs des champs [COMPLICATION.GOAL_PROGRESS_COLORS_INTERPOLATE] ou [COMPLICATION.RANGED_VALUE_COLORS_INTERPOLATE]. Lorsque vous l'utilisez pour représenter les données de complication WEIGHTED_ELEMENTS, définissez interpolate sur false.

La valeur par défaut est false.

cap

Déterminez la forme du contour du trait. Valeurs acceptées :

• BUTT entraîne la fin du trait par le tracé sans aucune projection au-delà.
• ROUND entraîne la projection du trait en tant que demi-cercle, avec le centre au bout du tracé.
• SQUARE entraîne la projection du trait en tant que carré, avec le centre au bout du tracé.

Éléments internes

L'élément WeightedStroke peut contenir les éléments suivants :

• Transform