Aree di delimitazione delle complicazioni

Le aree di delimitazione della complicazione vengono utilizzate per definire l'area di rendering di una complicazione. Nell'editor del quadrante viene mostrato un contorno dell'area delimitante. Tutti i contenuti al di fuori dell'area delimitata vengono ritagliati.

L'area delimitante determina anche la regione in cui l'utente può selezionare la complicazione dal quadrante.

Introdotta in Wear OS 4.

BoundingBox

Un elemento BoundingBox definisce un'area di delimitazione rettangolare per la complicazione.

Sintassi

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

Attributi

L'elemento BoundingBox prevede i seguenti attributi:

Attributi obbligatori

I seguenti attributi sono obbligatori:

x, y, width, height
Una raccolta di numeri interi che specificano le dimensioni e la posizione dell'elemento.

Attributi facoltativi

I seguenti attributi sono facoltativi:

outlinePadding
Un valore float che specifica il padding da applicare all'esterno dell'area delimitante. Viene utilizzato per creare un contorno più grande nell'editor del quadrante. Il valore predefinito è 0.

BoundingRoundBox

Un elemento BoundingRoundBox definisce un'area di delimitazione rettangolare con angoli arrotondati per la complicazione.

Sintassi

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

Attributi

L'elemento BoundingRoundBox prevede i seguenti attributi:

Attributi obbligatori

I seguenti attributi sono obbligatori:

x, y, width, height
Una raccolta di numeri interi che specificano le dimensioni e la posizione dell'elemento.

Attributi facoltativi

I seguenti attributi sono facoltativi:

cornerRadius

Il raggio di un cerchio. Questo valore definisce il grado di arrotondamento degli angoli del rettangolo.

outlinePadding
Un valore float che specifica il padding da applicare all'esterno dell'area delimitante. Viene utilizzato per creare un contorno più grande nell'editor del quadrante. Il valore predefinito è 0.

BoundingOval

Un elemento BoundingOval definisce un'area di delimitazione rotonda per la complicazione.

Sintassi

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

Attributi

L'elemento BoundingOval prevede i seguenti attributi:

Attributi obbligatori

I seguenti attributi sono obbligatori:

x, y, width, height
Una raccolta di numeri interi che specificano le dimensioni e la posizione dell'elemento.

Attributi facoltativi

I seguenti attributi sono facoltativi:

outlinePadding
Un valore float che specifica il padding da applicare all'esterno dell'area delimitante. Viene utilizzato per creare un contorno più grande nell'editor del quadrante. Il valore predefinito è 0.

BoundingArc

Un elemento BoundingArc definisce un'area di delimitazione a forma di arco per la complicazione.

Sintassi

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

Attributi

L'elemento BoundingArc prevede i seguenti attributi:

Attributi obbligatori

I seguenti attributi sono obbligatori:

centerX, centerY, width, height
Una raccolta di attributi che definiscono un'ellisse contenente per l'arco. L'arco viene ridimensionato in modo da adattarsi all'interno dell'ovale specificato. Tutti gli attributi sono definiti come valori numerici.
thickness
Lo spessore dell'arco espresso come numero in virgola mobile.
startAngle
Angolo iniziale (in gradi) in cui inizia l'arco. Un angolo di 0 gradi corrisponde alla posizione delle ore 12 sullo smartwatch.
endAngle
Angolo di fine, dove termina l'arco.

Attributi facoltativi

I seguenti attributi sono facoltativi:

isRoundEdge
Determina se il cappuccio all'estremità dell'arco è piatto o arrotondato. Il valore predefinito è FALSE.
direction
La direzione di rotazione dell'arco. Il valore predefinito è CLOCKWISE.
outlinePadding
Un valore float che specifica il padding da applicare all'esterno dell'area delimitante. Viene utilizzato per creare un contorno più grande nell'editor del quadrante. Il valore predefinito è 0.