Strefy utrudnień

Obszary ograniczające komplikacji służą do definiowania obszaru renderowania komplikacji. W edytorze tarczy zegarka wyświetla się zarys obszaru ograniczonego. Treści spoza obszaru ograniczonego są przycinane.

Obszar ograniczający określa też obszar, w którym użytkownik może wybrać komplikację na tarczy zegarka.

Wprowadzone w Wear OS 4.

BoundingBox

Element BoundingBox definiuje prostokątny obszar ograniczający komplikację.

Składnia

<BoundingBox x="integer" y="integer" width="integer" height="integer"
                outlinePadding="float" />

Atrybuty

Element BoundingBox ma te atrybuty:

Atrybuty wymagane

Wymagane są te atrybuty:

x, y, width, height
Kolekcja liczb całkowitych określających rozmiar i położenie elementu.

Atrybuty opcjonalne

Te atrybuty są opcjonalne:

outlinePadding
Liczba zmiennoprzecinkowa określająca odstęp od zewnętrznej krawędzi obszaru ograniczonego. Służy do tworzenia większego zarysu w edytorze tarczy zegarka. Wartość domyślna to 0.

BoundingRoundBox

Element BoundingRoundBox definiuje prostokątny obszar ograniczający z zaokrąglonymi narożnikami dla widżetu.

Składnia

<BoundingRoundBox x="integer" y="integer" width="integer" height="integer"
                outlinePadding="float" cornerRadius="float" />

Atrybuty

Element BoundingRoundBox ma te atrybuty:

Atrybuty wymagane

Wymagane są te atrybuty:

x, y, width, height
Kolekcja liczb całkowitych określających rozmiar i położenie elementu.

Atrybuty opcjonalne

Te atrybuty są opcjonalne:

cornerRadius

Promień koła. Ta wartość określa stopień zaokrąglenia rogów prostokąta.

outlinePadding
Liczba zmiennoprzecinkowa określająca odstęp od zewnętrznej krawędzi obszaru ograniczonego. Służy do tworzenia większego zarysu w edytorze tarczy zegarka. Domyślna wartość to 0.

BoundingOval

Element BoundingOval definiuje okrągły obszar ograniczający komplikację.

Składnia

<BoundingOval x="integer" y="integer" width="integer" height="integer"
                outlinePadding="float" />

Atrybuty

Element BoundingOval ma te atrybuty:

Atrybuty wymagane

Wymagane są te atrybuty:

x, y, width, height
Kolekcja liczb całkowitych określających rozmiar i położenie elementu.

Atrybuty opcjonalne

Te atrybuty są opcjonalne:

outlinePadding
Wartość typu float określająca wypełnienie, które ma być stosowane na zewnątrz obszaru ograniczonego. Służy do tworzenia większego zarysu w edytorze tarczy zegarka. Domyślna wartość to 0.

BoundingArc

Element BoundingArc definiuje obszar ograniczony łukiem dla widżetu.

Składnia

<BoundingArc centerX="float" centerY="float" width="float"
                height="float" thickness="float" isRoundEdge="boolean"
                startAngle="float" endAngle="float"
                direction="CLOCKWISE | COUNTER_CLOCKWISE"
                outlinePadding="float" />

Atrybuty

Element BoundingArc ma te atrybuty:

Atrybuty wymagane

Wymagane są te atrybuty:

centerX, centerY, width, height
Zbiór atrybutów, które definiują owalny element zawierający łuk. Krzywa jest skalowana, aby zmieścić się w określonym owalnym obszarze. Wszystkie atrybuty są zdefiniowane jako liczby zmiennoprzecinkowe.
thickness
Grubość łuku wyrażona jako liczba zmiennoprzecinkowa.
startAngle
Kąt początkowy (w stopniach), w którym zaczyna się łuk. Kąt 0 stopni odpowiada pozycji wskazówek zegara na godzinie 12.
endAngle
Kąt końcowy, w którym kończy się łuk.

Atrybuty opcjonalne

Te atrybuty są opcjonalne:

isRoundEdge
Określa, czy wierzchołek na końcu łuku jest płaski czy zaokrąglony. Domyślnie ustawiona na FALSE.
direction
Kierunek obrotu łuku. Domyślna wartość to CLOCKWISE.
outlinePadding
Wartość typu float określająca wypełnienie, które ma być stosowane na zewnątrz obszaru ograniczonego. Służy do tworzenia większego konturu w edytorze tarczy zegarka. Domyślna wartość to 0.