Trait pondéré

Depuis la version 2

Motif de trait avec des segments individuels, qui peuvent utiliser les épaisseurs et les couleurs spécifiées. 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 la forme d'une liste de valeurs hexadécimales séparées par un espace, par exemple : #FF0000 #00FF00 #0000FF.

Lorsqu'il est utilisé pour afficher les 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.

Cet attribut est transformable.

Attributs facultatifs

Les attributs suivants sont facultatifs :

weights

Liste de valeurs séparées par des espaces, qui déterminent la proportion de l'arc occupée par chaque poids, 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 des 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

Lorsque la valeur est définie sur true, chaque élément N de la liste weights présente un dégradé de couleur de la couleur N à la couleur N+1 de la liste colors, par opposition à une couleur unie.

Lorsque vous les utilisez pour représenter des données provenant 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]. Lorsqu'il est utilisé 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 :