TextCircular

Spécifie une configuration de texte circulaire ou incurvée.

Introduit dans Wear OS 4.

Syntaxe

<TextCircular centerX="float" centerY="float"
              direction="CLOCKWISE | COUNTER_CLOCKWISE" width="float"
              height="float" startAngle="float-degrees"
              endAngle="float-degrees" align="START | CENTER | END"
              ellipsis="boolean" >
    <!-- Possible inner elements. The PartText element syntax shows a
         more complete example. -->
    <Transform .../>
    <Font ... />
    <BitmapFont ... />
</TextCircular>

Attributs

L'élément TextCircular comporte les attributs suivants. Certains attributs sont obligatoires, alors que d'autres sont facultatifs.

Attributs obligatoires

Les attributs suivants sont obligatoires :

centerX et centerY

Paire de valeurs à virgule flottante spécifiant la position du centre de l'élément.

Ces attributs sont transformables.

width et height

Paire de valeurs à virgule flottante spécifiant la taille de l'élément.

startAngle et endAngle

Paire de valeurs à virgule flottante spécifiant l'angle de début du texte et l'angle de fin du texte, respectivement. Un angle de 0 degré représente la position "12 heures" sur le cadran.

Par exemple, pour incurver le texte autour du quart supérieur du cadran, utilisez un startAngle de 335.0 et un endAngle de 45.0.

Ces attributs sont transformables.

Attributs facultatifs

Les attributs suivants sont facultatifs :

direction

Indique le sens du texte :

  • CLOCKWISE : affiche le texte dans le sens des aiguilles d'une montre.
  • COUNTER_CLOCKWISE : affiche le texte dans le sens inverse des aiguilles d'une montre.
align

Détermine l'alignement du texte dans son élément parent :

  • START : aligné à gauche ou en haut (aligné à droite lorsque la langue active se lit de droite à gauche)
  • CENTER : aligné au centre
  • END : aligné à droite ou en bas (aligné à gauche lorsque la langue active se lit de droite à gauche)

La valeur par défaut est CENTER.

ellipsis

Valeur booléenne indiquant si des points de suspension doivent être ajoutés lorsque le texte est trop long pour tenir dans l'élément parent. La valeur par défaut est FALSE.

Éléments internes

L'élément Text peut contenir un nombre illimité d'éléments internes tels que les suivants :