TimeText

Ein Zeittext ist ein formatierter String, der die aktuelle Uhrzeit darstellt.

In Wear OS 4 eingeführt.

Syntax

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

Attribute

Das TimeText-Element hat die folgenden Attribute:

Erforderliche Attribute

Die folgenden Attribute sind erforderlich:

format

Ein Formatstring, der das Zeitformat angibt.

Diese Liste enthält mehrere verschiedene Formate für die Uhrzeit 12:34:56 Uhr:

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

Eine Sammlung von Ganzzahlen, die die Größe und Position des Elements angeben.

Optionale Attribute

Die folgenden Attribute sind optional:

hourFormat
Ob die Uhrzeit im 12- oder 24-Stunden-Format angezeigt werden soll. Standardmäßig ist SYNC_TO_DEVICE festgelegt. In diesem Fall wird die Einstellung des Nutzers angewendet, die auf dem Gerät konfiguriert ist.
align:
Text innerhalb des Begrenzungsrahmens ausrichten Standardmäßig ist „START“ festgelegt.
pivotX, pivotY
Ein zweidimensionaler Drehpunkt, um den sich das Element dreht. Beide Werte sind Gleitkommazahlen, die so skaliert sind, dass sie in den Bereich $ [0, 1] $ passen.
angle
Die Anzahl der Grad, um die das Element im Uhrzeigersinn um seinen Drehpunkt gedreht werden soll.
alpha
Legen Sie die Transparenz dieses Elements fest. Der Wert 0 gibt an, dass das Element vollständig transparent sein soll. Ein Wert von 255 gibt an, dass das Element vollständig undurchsichtig sein soll.
tintColor
Wenden Sie einen Farbtonfilter auf das Element an. Sie müssen die Farbe entweder im ARGB-Format (#ff000000 = opakes Schwarz) oder im RGB-Format (#000000 = Schwarz) angeben.

Innere Elemente

Das TimeText-Element kann die folgenden inneren Elemente enthalten:

Variant
Ermöglicht das Ändern von Attributen dieses Elements, wenn sich das Wear OS-Gerät im Bildschirmschonermodus befindet. Weitere Informationen finden Sie in der Variant-Referenz.
BitmapFont
Ein BitmapFont, der zum Rendern der Uhrzeit verwendet werden soll.
Font
Eine Schriftart, die für das Rendern der Uhrzeit verwendet werden soll.