Testo temporale

Un testo dell'ora è una stringa formattata che rappresenta l'ora corrente.

Introdotta in Wear OS 4.

Sintassi

<TimeText format="string" hourFormat="12 | 24 | SYNC_TO_DEVICE"
             align="START | CENTER | END" x="integer" y="integer"
             width="integer" height="integer" pivotX="float" pivotY="float"
             angle="float-degrees" alpha="integer"
             tintColor="argb-color | rgb-color" />

Attributi

L'elemento TimeText prevede i seguenti attributi:

Attributi obbligatori

I seguenti attributi sono obbligatori:

format

Una stringa di formato che rappresenta il formato dell'ora.

Questo elenco include diversi formati per mostrare l'ora 12:34:56 PM:

  • hh:mm:ss viene visualizzato come "12:34:56".
  • h:mm viene visualizzato come "12:34"
  • hh_10 viene visualizzato come "1".
  • hh_1 viene visualizzato come "2".
  • m viene visualizzato come "34"
  • mm_10 viene visualizzato come "3".
  • mm_1 viene visualizzato come "4".
  • ss viene visualizzato come "56"
  • ss_10 viene visualizzato come "5".
  • ss_1 viene visualizzato come "6".
x, y, width, height

Una raccolta di numeri interi che specificano le dimensioni e la posizione dell'elemento.

Attributi facoltativi

I seguenti attributi sono facoltativi:

hourFormat
Se utilizzare la notazione delle ore 12 o 24 per visualizzare l'ora. Il valore predefinito è SYNC_TO_DEVICE, che applica la preferenza dell'utente configurata sul dispositivo.
align:
Come allineare il testo all'interno della casella delimitante. Il valore predefinito è "START".
pivotX, pivotY
Un punto di rotazione bidimensionale attorno al quale ruota l'elemento. Entrambi i valori sono numeri a virgola mobile che vengono scalati in modo da rientrare nell'intervallo $ [0, 1] $.
angle
Il numero di gradi in senso orario di cui ruotare l'elemento attorno al suo centro di rotazione.
alpha
Imposta il livello di trasparenza che deve avere questo elemento. Un valore 0 indica che l'elemento deve essere completamente trasparente. Un valore 255 indica che l'elemento deve essere completamente opaco.
tintColor
Applica un filtro di tinta all'elemento. Devi specificare il colore utilizzando il formato ARGB (#ff000000 = nero opaco) o il formato RGB (#000000 = nero).

Elementi interni

L'elemento TimeText può contenere i seguenti elementi interni:

Variant
Consente di modificare gli attributi di questo elemento quando il dispositivo Wear OS è in modalità Ambient. Per saperne di più, consulta la documentazione di riferimento di Variant.
BitmapFont
Un BitmapFont da utilizzare per il rendering dell'ora.
Font
Un carattere da utilizzare per il rendering dell'ora.