ComplicationSlot

Version du format de cadran <ph type="x-smartling-placeholder"></ph> Version 2 Version 1

---

Un emplacement de complication est une zone du cadran qu'un utilisateur peut ajouter dans l'interface de la complication. Les emplacements de complication contiennent des éléments de complication, qui définissent l'affichage pour différents types de complications et dans différents modes de cadran.

Remarque : Un cadran ne peut pas comporter plus de huit instances de ComplicationSlot.

Introduit dans Wear OS 4.

Syntaxe

<ComplicationSlot x="integer" y="integer" width="integer"
             height="integer" pivotX="float" pivotY="float"
             angle="float-degrees" alpha="integer" slotId="integer"
             name="string" displayName="string" scaleX="float" scaleY="float"
             supportedTypes="string" isCustomizable="boolean"
             tintColor="argb-color | rgb-color" />

Attributs

ComplicationSlot présente 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.

slotId

Identifiant numérique unique de l'emplacement.

supportedTypes

Liste des types de complications compatibles pouvant remplir l'emplacement. Les valeurs acceptées sont SHORT_TEXT, LONG_TEXT, MONOCHROMATIC_IMAGE, SMALL_IMAGE, PHOTO_IMAGE, RANGED_VALUE et EMPTY. Vous pouvez utiliser plusieurs types de complications en les séparant par un espace (par exemple, SHORT_TEXT RANGED_VALUE).

Attributs facultatifs

Les attributs suivants sont facultatifs :

pivotX, pivotY

Point pivot bidimensionnel autour duquel l'élément pivote. Les deux valeurs sont des nombres à virgule flottante qui sont ajustés pour tenir dans la plage $ [0, 1] $.

angle

Un certain nombre de degrés de rotation de l'élément autour de son point pivot (dans le sens des aiguilles d'une montre).

alpha

Définissez le niveau de transparence à appliquer à cet élément. La valeur 0 indique que l'élément doit être totalement transparent. La valeur 255 indique que l'élément doit être complètement opaque.

scaleX

Facteur de scaling horizontal à appliquer à cet élément.

scaleY

Facteur de scaling vertical à appliquer à cet élément.

tintColor

Appliquez un filtre de couleur (teinte) à l'élément. Vous devez spécifier la couleur au format ARVB (#ff000000 = noir opaque) ou au format RVB (#000000 = noir).

displayName

ID de ressource correspondant à un nom localisé pour l'emplacement de la complication, qui s'affiche dans l'éditeur de cadran.

isCustomizable

Détermine si un utilisateur peut modifier le fournisseur de cet emplacement dans l'éditeur de cadran. La valeur par défaut est TRUE.

Éléments internes

L'élément ComplicationSlot doit contenir exactement un seul élément Zone de délimitation.

Un élément ComplicationSlot doit contenir au moins un élément Complication pour chaque type de complication compatible. Un élément ComplicationSlot peut éventuellement contenir plus d'éléments Complication pour permettre la modification de l'apparence avec les éléments Variant.

L'élément ComplicationSlot peut également contenir les éléments internes suivants :

• DefaultProviderPolicy
• Variant
• ScreenReader