TimeText

Un texte temporel est une chaîne mise en forme représentant l'heure actuelle.

Introduit dans Wear OS 4.

Syntaxe

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

Attributs

L'élément TimeText comporte les attributs suivants :

Attributs obligatoires

Les attributs suivants sont obligatoires :

format

Chaîne de format représentant le format d'heure.

Cette liste comprend plusieurs formats pour afficher l'heure 12:34:56:

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

Ensemble d'entiers qui spécifient la taille et la position de l'élément.

Attributs facultatifs

Les attributs suivants sont facultatifs :

hourFormat
Permet d'utiliser le format 12 ou 24 heures pour afficher l'heure. La valeur par défaut est SYNC_TO_DEVICE, ce qui applique la préférence de l'utilisateur configurée sur l'appareil.
align :
Indique comment aligner le texte dans la zone de délimitation. La valeur par défaut est "START" (DÉBUT).
pivotX, pivotY
Point pivot bidimensionnel autour duquel l'élément pivote. Les deux valeurs sont des nombres à virgule flottante qui sont ajustés pour tenir dans la plage $ [0, 1] $.
angle
Un certain nombre de degrés de rotation de l'élément autour de son point pivot (dans le sens des aiguilles d'une montre).
alpha
Définissez le niveau de transparence à appliquer à cet élément. La valeur 0 indique que l'élément doit être totalement transparent. La valeur 255 indique que l'élément doit être complètement opaque.
tintColor
Appliquez un filtre de couleur (teinte) à l'élément. Vous devez spécifier la couleur au format ARVB (#ff000000 = noir opaque) ou au format RVB (#000000 = noir).

Éléments internes

L'élément TimeText peut contenir les éléments internes suivants :

Variant
Permet de modifier les attributs de cet élément lorsque l'appareil Wear OS est en mode Veille. Pour en savoir plus, consultez la documentation de référence sur Variant.
BitmapFont
BitmapFont à utiliser pour le rendu de l'heure.
Font
Font à utiliser pour le rendu de l'heure.