Testo circolare

Specifica una configurazione di testo circolare o curvo.

Introdotta in Wear OS 4.

Sintassi

<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>

Attributi

L'elemento TextCircular prevede i seguenti attributi. Alcuni attributi sono obbligatori, mentre altri sono facoltativi.

Attributi obbligatori

I seguenti attributi sono obbligatori:

centerX e centerY

Una coppia di valori in virgola mobile che specificano la posizione del centro dell'elemento.

Questi attributi sono trasformabili.

width e height

Una coppia di valori in virgola mobile che specificano le dimensioni dell'elemento.

startAngle e endAngle

Una coppia di valori in virgola mobile che specificano rispettivamente l'angolo del lato iniziale e l'angolo del lato finale del testo. Un angolo di 0 gradi rappresenta la posizione delle ore 12 sul quadrante.

Ad esempio, per curvare il testo attorno al quarto superiore del quadrante, utilizza un valore startAngle di 335.0 e un valore endAngle di 45.0.

Questi attributi sono trasformabili.

Attributi facoltativi

I seguenti attributi sono facoltativi:

direction

Indica la direzione in cui è scritto il testo:

  • CLOCKWISE (valore predefinito): mostra il testo in senso orario.
  • COUNTER_CLOCKWISE: mostra il testo in senso antiorario.
align

Determina l'allineamento del testo all'interno dell'elemento principale:

  • START: allineato a sinistra o in alto (allineato a destra quando la lingua corrente utilizza una direzione del testo RTL)
  • CENTER: allineamento al centro
  • END: allineamento a destra o in basso (allineamento a sinistra quando la lingua corrente utilizza una direzione di testo RTL)

Il valore predefinito è CENTER.

ellipsis

Un valore booleano che indica se mostrare i puntini di sospensione se il testo è troppo lungo per essere visualizzato nell'elemento principale. Il valore predefinito è FALSE.

Elementi interni

L'elemento Text può contenere un numero qualsiasi dei seguenti elementi interni: