TextCircular

Określa konfigurację tekstu okrągłego lub zakrzywionego.

Wprowadzona w Wear OS 4.

Składnia

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

Atrybuty

Element TextCircular ma poniższe atrybuty. Niektóre atrybuty są wymagane, a inne opcjonalne.

Atrybuty wymagane

Wymagane są te atrybuty:

centerX i centerY
Para wartości zmiennoprzecinkowych określających położenie środka elementu.
width i height
Para wartości zmiennoprzecinkowych określająca rozmiar elementu.
startAngle i endAngle

Para wartości zmiennoprzecinkowych określająca odpowiednio kąt między stroną początkową tekstu a kąt jego końca. Kąt równy 0 stopni oznacza położenie dwunastu na tarczy zegarka.

Aby na przykład zakrzywić tekst w górnej ćwiartce tarczy zegarka, użyj funkcji startAngle równych 335.0 i endAngle o wartości 45.0.

Atrybuty opcjonalne

Te atrybuty są opcjonalne:

direction

Wskazuje kierunek, w którym pisany jest tekst:

  • CLOCKWISE (domyślnie): wyświetla tekst w kierunku zgodnym z ruchem wskazówek zegara.
  • COUNTER_CLOCKWISE: wyświetla tekst w kierunku przeciwnym do ruchu wskazówek zegara.
align

Określa wyrównanie tekstu w elemencie nadrzędnym:

  • START: wyrównanie do lewej lub do góry (wyrównanie do prawej, gdy w bieżącym języku masz ustawiony kierunek tekstu od prawej do lewej)
  • CENTER: wyrównane do środka
  • END: wyrównanie do prawej lub do dołu (wyrównanie do lewej, gdy w bieżącym języku masz ustawiony kierunek tekstu od prawej do lewej)

Wartość domyślna to CENTER.

ellipsis

Wartość logiczna wskazująca, czy wyświetlić wielokropek, jeśli tekst jest zbyt długi, aby zmieścić się w elemencie nadrzędnym. Wartość domyślna to FALSE.

Elementy wewnętrzne

Element Text może zawierać dowolną liczbę tych elementów wewnętrznych: