Zones de délimitation des complications

Les zones de délimitation d'une complication permettent de définir l'espace de rendu d'une complication. Un contour de la zone de délimitation est affiché dans l'éditeur de cadran. Tout contenu situé en dehors de la zone de délimitation est recadré.

Le cadre de délimitation détermine également la région dans laquelle l'utilisateur peut sélectionner la complication sur le cadran.

Introduit dans Wear OS 4.

BoundingBox

Un élément BoundingBox définit une zone de délimitation rectangulaire pour la complication.

Syntaxe

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

Attributs

L'élément BoundingBox comporte les attributs suivants :

Attributs obligatoires

Les attributs suivants sont obligatoires :

x, y, width, height
Ensemble d'entiers qui spécifient la taille et la position de l'élément.

Attributs facultatifs

Les attributs suivants sont facultatifs :

outlinePadding
Float spécifiant la marge intérieure à appliquer à l'extérieur de la zone de délimitation. Cela permet de créer un plus grand contour dans l'éditeur de cadran. La valeur par défaut est 0.

BoundingRoundBox

Un élément BoundingRoundBox définit une zone de délimitation rectangulaire avec des coins arrondis pour la complication.

Syntaxe

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

Attributs

L'élément BoundingRoundBox comporte les attributs suivants :

Attributs obligatoires

Les attributs suivants sont obligatoires :

x, y, width, height
Ensemble d'entiers qui spécifient la taille et la position de l'élément.

Attributs facultatifs

Les attributs suivants sont facultatifs :

cornerRadius

Rayon d'un cercle. Cette valeur définit dans quelle mesure les coins du rectangle sont arrondis.

outlinePadding
Float spécifiant la marge intérieure à appliquer à l'extérieur de la zone de délimitation. Cela permet de créer un plus grand contour dans l'éditeur de cadran. La valeur par défaut est 0.

BoundingOval

Un élément BoundingOval définit une zone de délimitation arrondie pour la complication.

Syntaxe

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

Attributs

L'élément BoundingOval comporte les attributs suivants :

Attributs obligatoires

Les attributs suivants sont obligatoires :

x, y, width, height
Ensemble d'entiers qui spécifient la taille et la position de l'élément.

Attributs facultatifs

Les attributs suivants sont facultatifs :

outlinePadding
Float spécifiant la marge intérieure à appliquer à l'extérieur de la zone de délimitation. Cela permet de créer un plus grand contour dans l'éditeur de cadran. La valeur par défaut est 0.

BoundingArc

Un élément BoundingArc définit une zone de délimitation en forme d'arc pour la complication.

Syntaxe

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

Attributs

L'élément BoundingArc comporte les attributs suivants :

Attributs obligatoires

Les attributs suivants sont obligatoires :

centerX, centerY, width, height
Ensemble d'attributs qui définissent un ovale conteneur pour l'arc. L'arc est mis à l'échelle pour s'adapter à l'ovale spécifié. Tous les attributs sont définis comme des flottants.
thickness
Épaisseur de l'arc exprimée sous la forme d'un flottant.
startAngle
Angle de départ (en degrés) à partir duquel l'arc commence. Un angle de 0 degré correspond à la position de 12 heures sur la montre.
endAngle
Angle de fin, où l'arc se termine.

Attributs facultatifs

Les attributs suivants sont facultatifs :

isRoundEdge
Détermine si la pointe à l'extrémité de l'arc est plate ou arrondie. Par défaut, cette valeur est FALSE.
direction
Sens de rotation de l'arc. La valeur par défaut est CLOCKWISE.
outlinePadding
Float spécifiant la marge intérieure à appliquer à l'extérieur de la zone de délimitation. Cela permet de créer un plus grand contour dans l'éditeur de cadran. La valeur par défaut est 0.