TextCircular

Gibt eine Konfiguration mit kreisförmigem oder gebogenem Text an.

Eingeführt in Wear OS 4.

Syntax

<TextCircular centerX="float" centerY="float"
              direction="CLOCKWISE | COUNTER_CLOCKWISE" width="float"
              height="float" startAngle="float-degrees"
              endAngle="float-degrees" align="START | CENTER | END"
              ellipsis="boolean" >
    <!-- Possible inner elements. The PartText element syntax shows a
         more complete example. -->
    <Transform .../>
    <Font ... />
    <BitmapFont ... />
</TextCircular>

Merkmale

Das TextCircular-Element hat die folgenden Attribute. Einige Attribute sind erforderlich, andere sind optional.

Erforderliche Attribute

Die folgenden Attribute sind erforderlich:

centerX und centerY
Ein Paar von Gleitkommawerten, die die Position des Elementmittelpunkts angeben.
width und height
Ein Paar Gleitkommawerte, die die Größe des Elements angeben.
startAngle und endAngle

Ein Paar von Gleitkommawerten, die den Winkel der Anfangsseite des Texts bzw. den Winkel an der Endseite des Texts angeben. Ein Winkel von 0 Grad repräsentiert die 12-Uhr-Position auf dem Zifferblatt.

Soll der Text z. B. um das obere Viertel des Zifferblatts gekrümmt werden, verwenden Sie für startAngle 335.0 und für endAngle 45.0.

Optionale Attribute

Die folgenden Attribute sind optional:

direction

Gibt die Richtung an, in die der Text geschrieben wird:

  • CLOCKWISE (Standard): Text wird im Uhrzeigersinn angezeigt.
  • COUNTER_CLOCKWISE: Text entgegen dem Uhrzeigersinn anzeigen.
align

Bestimmt die Textausrichtung innerhalb des übergeordneten Elements:

  • START: links- oder oben ausgerichtet (rechtsbündig, wenn die aktuelle Sprache eine RTL-Textrichtung verwendet)
  • CENTER: zentriert
  • END: rechts- oder unten ausgerichtet (linksbündig, wenn die aktuelle Sprache eine RTL-Textrichtung verwendet)

Der Standardwert ist CENTER.

ellipsis

Boolescher Wert, der angibt, ob Auslassungspunkte angezeigt werden sollen, wenn der Text zu lang für das übergeordnete Element ist. Der Standardwert ist FALSE.

Innere Elemente

Das Text-Element kann eine beliebige Anzahl der folgenden Elemente enthalten: