Aree di delimitazione delle complicazioni


Le aree di delimitazione delle complicazioni vengono utilizzate per definire l'area di rendering per una complicazione. Un contorno dell'area di delimitazione viene mostrato nell'editor dei quadranti. I contenuti al di fuori dell'area di delimitazione vengono ritagliati.

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

Introdotta in Wear OS 4.

Riquadro di delimitazione

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 ha i seguenti attributi:

Attributi obbligatori

I seguenti attributi sono obbligatori:

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

Attributi facoltativi

I seguenti attributi sono facoltativi:

outlinePadding
Un numero in virgola mobile che specifica la spaziatura interna da applicare all'esterno dell'area di delimitazione. Questo viene utilizzato per creare un contorno più grande nell'editor dei quadranti. Il valore predefinito è 0.

Riquadro Rotondo di delimitazione

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 ha i seguenti attributi:

Attributi obbligatori

I seguenti attributi sono obbligatori:

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

Attributi facoltativi

I seguenti attributi sono facoltativi:

cornerRadius

Il raggio di un cerchio. Questo valore definisce la misura in cui gli angoli del rettangolo vengono arrotondati.

outlinePadding
Un numero in virgola mobile che specifica la spaziatura interna da applicare all'esterno dell'area di delimitazione. Questo viene utilizzato per creare un contorno più grande nell'editor dei quadranti. Il valore predefinito è 0.

Ovale

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 ha i seguenti attributi:

Attributi obbligatori

I seguenti attributi sono obbligatori:

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

Attributi facoltativi

I seguenti attributi sono facoltativi:

outlinePadding
Un numero in virgola mobile che specifica la spaziatura interna da applicare all'esterno dell'area di delimitazione. Questo viene utilizzato per creare un contorno più grande nell'editor dei quadranti. Il valore predefinito è 0.

Arco di delimitazione

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 ha i seguenti attributi:

Attributi obbligatori

I seguenti attributi sono obbligatori:

centerX, centerY, width, height
Una raccolta di attributi che definiscono un ovale contenitore per l'arco. L'arco viene ridimensionato per adattarsi all'ovale specificato. Tutti gli attributi sono definiti come valori in virgola mobile.
thickness
Lo spessore dell'arco espresso come valore in virgola mobile.
startAngle
Angolo iniziale (in gradi) nel punto in cui inizia l'arco. Un angolo di 0 gradi corrisponde alla posizione a ore 12 sull'orologio.
endAngle
Angolo finale, dove finisce l'arco.

Attributi facoltativi

I seguenti attributi sono facoltativi:

isRoundEdge
Determina se il cappello alla fine dell'arco è piatto o arrotondato. Il valore predefinito è FALSE.
direction
La direzione di rotazione dell'arco. Il valore predefinito è CLOCKWISE.
outlinePadding
Un numero in virgola mobile che specifica la spaziatura interna da applicare all'esterno dell'area di delimitazione. Questo viene utilizzato per creare un contorno più grande nell'editor dei quadranti. Il valore predefinito è 0.