Strefy utrudnień

Obszary ograniczające widżet służą do określania obszaru renderowania widżety. Kontur obszaru granicy wyświetla się w edytorze tarczy zegarka. Zawartość spoza tego obszaru zostanie przycięta.

Obszar ograniczający określa też 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 zostać zastosowane poza obszarem granicznym. Pozwala to utworzyć większy kontur w edytorze tarczy zegarka. Domyślna wartość to 0.

BoundingRoundBox

Element BoundingRoundBox określa prostokątny obszar graniczny z zaokrąglonymi rogami 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. Określa stopień zaokrąglania rogów prostokąta.

outlinePadding
Liczba zmiennoprzecinkowa określająca dopełnienie, które ma zostać zastosowane poza obszarem granicznym. Pozwala to utworzyć większy kontur w edytorze tarczy zegarka. Domyślna wartość to 0.

GranicaOwal

Element BoundingOval określa okrągły obszar graniczny widżetu.

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 zostać zastosowane poza obszarem granicznym. Pozwala to utworzyć większy kontur w edytorze tarczy zegarka. Domyślna wartość to 0.

Łuk graniczny

Element BoundingArc określa łukowy obszar ograniczający widżet.

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ą zawierający owal łuku. Łuk jest skalowany tak, aby pasował do określonego owalu. Wszystkie atrybuty są zdefiniowane jako liczby zmiennoprzecinkowe.
thickness
Grubość łuku wyrażona w postaci liczby zmiennoprzecinkowej.
startAngle
Kąt początkowy (w stopniach), w którym zaczyna się łuk. Kąt równy 0 stopni odpowiada pozycji 12:00 na zegarku.
endAngle
Kąt końcowy, w którym kończy się łuk.

Atrybuty opcjonalne

Te atrybuty są opcjonalne:

isRoundEdge
Określa, czy zakończenie na końcu łuku jest płaskie czy zaokrąglone. Wartość domyślna to FAŁSZ.
direction
Kierunek obrotu łuku. Domyślna wartość to CLOCKWISE.
outlinePadding
Liczba zmiennoprzecinkowa określająca dopełnienie, które ma zostać zastosowane poza obszarem granicznym. Pozwala to utworzyć większy kontur w edytorze tarczy zegarka. Domyślna wartość to 0.