Testo temporale

Un testo orario è 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 ha 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 alle 12:34:56:

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

Un insieme di numeri interi che specificano la dimensione e la posizione dell'elemento.

Attributi facoltativi

I seguenti attributi sono facoltativi:

hourFormat
Indica se utilizzare la notazione a 12 o 24 ore 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 del riquadro di delimitazione. Il valore predefinito è "START".
pivotX, pivotY
Un punto pivot bidimensionale su cui ruota l'elemento. Entrambi i valori sono numeri in virgola mobile scalati per rientrare nell'intervallo $ [0, 1] $.
angle
Un numero di gradi, in senso orario, per cui l'elemento deve essere ruotato attorno al suo punto di rotazione.
alpha
Imposta il livello di trasparenza che questo elemento deve avere. Il valore 0 indica che l'elemento deve essere completamente trasparente. Il valore 255 indica che l'elemento deve essere completamente opaco.
tintColor
Applica all'elemento un filtro di colore per la tinta. 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 la modifica degli attributi di questo elemento quando il dispositivo Wear OS è in modalità Ambient. Maggiori informazioni sono disponibili nel riferimento di Variant.
BitmapFont
Un BitmapFont da utilizzare per il rendering dell'ora.
Font
Un carattere da utilizzare per il rendering del tempo.