Gewichteter Strich

Seit Version 2

Ein Strichmuster mit einzelnen Segmenten, die bestimmte Gewichtungen und Farben annehmen können. Insbesondere beim Rendern von GOAL_PROGRESS-, RANGED_VALUE- und WEIGHTED_ELEMENTS-Zusatzfunktionen.

Syntax

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

Attribute

Das WeightedStroke-Element hat die folgenden Attribute:

Erforderliche Attribute

Die folgenden Attribute sind erforderlich:

colors

Die Farben der einzelnen Elemente des gewichteten Strichs als durch Leerzeichen getrennte Liste von Hexadezimalwerten, z. B. #FF0000 #00FF00 #0000FF.

Wenn colors zum Rendern von GOAL_PROGRESS- oder RANGED_VALUE-Komplikationsdaten verwendet wird, die Farbdaten liefern, oder mit WEIGHTED_ELEMENTS, kann colors direkt mit [COMPLICATION.GOAL_PROGRESS_COLORS], [COMPLICATION.RANGED_VALUE_COLORS] oder [COMPLICATION.WEIGHTED_ELEMENTS_COLORS] ausgefüllt werden.

thickness

Die Strichstärke als Gleitkommadimension.

Dieses Attribut ist transformierbar.

Optionale Attribute

Die folgenden Attribute sind optional:

weights

Eine durch Leerzeichen getrennte Liste von Werten, die den Anteil des Bogens bestimmen, der von jedem Gewicht eingenommen wird, z. B. 1.0 2.0 3.0, wobei das dritte Element den dreifachen Winkel des ersten Elements einnimmt.

Wenn Daten aus der Zusatzfunktion WEIGHTED_ELEMENTS dargestellt werden, kann [COMPLICATION.WEIGHTED_ELEMENTS_WEIGHTS] direkt übergeben werden.

discreteGap

Der Winkel zwischen den einzelnen Elementen. Die Standardeinstellung ist 0.0.

interpolate

Wenn „true“ festgelegt ist, hat jedes Element N aus der Liste weights einen Farbverlauf von Farbe N zu Farbe N+1 aus der Liste colors, anstatt eine durchgehende Farbe.

Wenn Sie Daten aus GOAL_PROGRESS- oder RANGED_VALUE-Komplikationen darstellen möchten, können Sie Werte für die Felder [COMPLICATION.GOAL_PROGRESS_COLORS_INTERPOLATE] oder [COMPLICATION.RANGED_VALUE_COLORS_INTERPOLATE] direkt übergeben. Wenn Sie WEIGHTED_ELEMENTS-Komplikationsdaten darstellen, setzen Sie interpolate auf false.

Die Standardeinstellung ist false.

cap

Bestimmen Sie die Form der Kontur. Unterstützte Werte:

  • BUTT bewirkt, dass der Strich am Pfad endet und nicht darüber hinausragt.
  • ROUNDbewirkt, dass der Strich als Halbkreis projiziert wird, dessen Mittelpunkt sich am Ende des Pfades befindet.
  • Mit SQUARE wird der Strich als Quadrat dargestellt, dessen Mittelpunkt sich am Ende des Pfades befindet.

Innere Elemente

Das WeightedStroke-Element kann die folgenden Elemente enthalten: