TimeText

Un texto de hora es una cadena con formato que representa la hora actual.

Se introdujo en Wear OS 4.

Sintaxis

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

Atributos

El elemento TimeText tiene los siguientes atributos:

Atributos obligatorios

Se requieren los siguientes atributos:

format

Es una cadena de formato que representa el formato de hora.

Esta lista incluye varios formatos diferentes para mostrar la hora 12:34:56 p.m.:

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

Es una colección de números enteros que especifican el tamaño y la posición del elemento.

Atributos opcionales

Los siguientes atributos son opcionales:

hourFormat
Indica si se debe usar la notación de 12 o 24 horas para mostrar la hora. El valor predeterminado es SYNC_TO_DEVICE, que aplica la preferencia del usuario configurada en el dispositivo.
align
Define cómo alinear el texto dentro del cuadro delimitador. La configuración predeterminada es "START".
pivotX y pivotY
Es un punto de pivote bidimensional sobre el que rota el elemento. Ambos valores son números de punto flotante que se ajustan para adaptarse al rango $ [0, 1] $.
angle
Es la cantidad de grados, en el sentido de las manecillas del reloj, que el elemento debe rotar sobre su punto de pivote.
alpha
Establece el nivel de transparencia que debe tener este elemento. Un valor de 0 indica que el elemento debe ser completamente transparente. Un valor de 255 indica que el elemento debe ser completamente opaco.
tintColor
Aplica un filtro de color de tono al elemento. Debes especificar el color con el formato ARGB (#ff000000 = negro opaco) o el formato RGB (#000000 = negro).

Elementos internos

El elemento TimeText puede contener los siguientes elementos internos:

Variant
Permite cambiar los atributos de este elemento cuando el dispositivo Wear OS está en modo ambiente. Puedes encontrar más información en la referencia de Variant.
BitmapFont
Es un elemento BitmapFont que se usará para renderizar la hora.
Font
Es un elemento Font que se usará para renderizar la hora.