Ważony pociąg

Od wersji 2

Wzorzec kreski i pojedyncze segmenty, który może mieć określoną wagę i kolor. W szczególności używa się go do renderowania widżetów GOAL_PROGRESS, RANGED_VALUE i WEIGHTED_ELEMENTS.

Składnia

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

Atrybuty

Element WeightedStroke ma te atrybuty:

Atrybuty wymagane

Wymagane są te atrybuty:

colors

Kolory każdego elementu kreski ważonej jako lista wartości szesnastkowych rozdzielonych spacjami, np. #FF0000 #00FF00 #0000FF.

Gdy używasz do renderowania danych widżetu GOAL_PROGRESS lub RANGED_VALUE, które udostępniają dane o kolorze, albo parametru WEIGHTED_ELEMENTS, pole colors może zostać zapełnione bezpośrednio wartościami [COMPLICATION.GOAL_PROGRESS_COLORS], [COMPLICATION.RANGED_VALUE_COLORS] lub [COMPLICATION.WEIGHTED_ELEMENTS_COLORS].

thickness

Grubość kreski wyrażona jako wymiar zmiennoprzecinkowy.

Atrybuty opcjonalne

Te atrybuty są opcjonalne:

weights

Lista wartości oddzielonych spacjami, która określa proporcje kąta zajmowanego przez każdą wagę, np. 1.0 2.0 3.0, gdzie trzeci element ma 3-krotność kąta pierwszego elementu.

Gdy używa się do reprezentowania danych z widżetu WEIGHTED_ELEMENTS, pole [COMPLICATION.WEIGHTED_ELEMENTS_WEIGHTS] może być przekazywane bezpośrednio.

discreteGap

Kąt między każdym elementem. Domyślna wartość to 0.0.

interpolate

Gdy ustawisz wartość true, każdy element N z listy weights ma gradient kolorów od koloru N do koloru N+1 z listy colors zamiast jednolitego koloru.

Gdy używasz go do reprezentowania danych z komplikacji GOAL_PROGRESS lub RANGED_VALUE, możesz przekazywać bezpośrednio wartości pól [COMPLICATION.GOAL_PROGRESS_COLORS_INTERPOLATE] lub [COMPLICATION.RANGED_VALUE_COLORS_INTERPOLATE]. Jeśli używasz do reprezentowania danych widżetu WEIGHTED_ELEMENTS, ustaw interpolate na false.

Domyślna wartość to false.

cap

Określ kształt krawędzi linii. Obsługiwane wartości to:

  • BUTT powoduje, że kreska kończy się ścieżką, a nie jest przenoszona poza ścieżkę.
  • ROUNDW ten sposób kreska wydaje się półokręgiem, którego środek znajduje się na końcu ścieżki.
  • SQUARE powoduje, że kreska jest wycelowana w kwadrat, a środek znajduje się na końcu ścieżki.

Elementy wewnętrzne

Element WeightedStroke może zawierać te elementy: