Strefy utrudnień

Obszary ograniczające widżety służą do określania obszaru renderowania na potrzeby kompilacji. W edytorze tarczy zegarka widoczny jest kontur obszaru ograniczającego. Wszystkie treści znajdujące się poza obszarem będą przycinane.

Obszar ograniczający określa również region, w którym użytkownik może wybrać widżet na tarczy zegarka.

Wprowadzona w Wear OS 4.

BoundingBox

Element BoundingBox określa prostokątny obszar ograniczający widżet.

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
Zbiór liczb całkowitych, które określają rozmiar i pozycję elementu.

Atrybuty opcjonalne

Te atrybuty są opcjonalne:

outlinePadding
Liczba zmiennoprzecinkowa określająca dopełnienie, które ma być stosowane do obszaru ograniczającego. Służy do tworzenia większego konturu w edytorze tarcz zegarka. Domyślna wartość to 0.

Ramka typuRoundBox

Element BoundingRoundBox określa prostokątny obszar ograniczający z zaokrąglonymi rogami 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
Zbiór liczb całkowitych, które określają rozmiar i pozycję elementu.

Atrybuty opcjonalne

Te atrybuty są opcjonalne:

cornerRadius

Promień okręgu. Ta wartość określa stopień zaokrąglenia rogów prostokąta.

outlinePadding
Liczba zmiennoprzecinkowa określająca dopełnienie, które ma być stosowane do obszaru ograniczającego. Służy do tworzenia większego konturu w edytorze tarcz zegarka. Domyślna wartość to 0.

Owal

Element BoundingOval określa okrągły obszar ograniczający widżet.

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
Zbiór liczb całkowitych, które określają rozmiar i pozycję elementu.

Atrybuty opcjonalne

Te atrybuty są opcjonalne:

outlinePadding
Liczba zmiennoprzecinkowa określająca dopełnienie, które ma być stosowane do obszaru ograniczającego. Służy do tworzenia większego konturu w edytorze tarcz zegarka. Domyślna wartość to 0.

BoundingArc

Element BoundingArc określa obszar ograniczający widżet w kształcie łuku.

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 definiujących owal zawierający łuk. Łuk jest skalowany, by pasował do określonego owalu. 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 zegarka 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 górna część łuku jest płaska czy zaokrąglona. Przyjmuje wartość domyślną FAŁSZ.
direction
Kierunek obrotu łuku. Domyślna wartość to CLOCKWISE.
outlinePadding
Liczba zmiennoprzecinkowa określająca dopełnienie, które ma być stosowane do obszaru ograniczającego. Służy do tworzenia większego konturu w edytorze tarcz zegarka. Domyślna wartość to 0.