متن دایره ای

پیکربندی متن دایره ای یا منحنی را مشخص می کند.

در Wear OS 4 معرفی شد.

نحو 

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

صفات

عنصر TextCircular دارای ویژگی های زیر است. برخی از ویژگی ها مورد نیاز هستند در حالی که برخی دیگر اختیاری هستند.

ویژگی های مورد نیاز

ویژگی های زیر مورد نیاز است:

centerX و centerY
یک جفت مقدار ممیز شناور که موقعیت مرکز عنصر را مشخص می کند.
width و height
یک جفت مقادیر ممیز شناور که اندازه عنصر را مشخص می کند.
startAngle و endAngle

یک جفت مقدار ممیز شناور که به ترتیب زاویه سمت شروع متن و زاویه سمت انتهای متن را مشخص می کند. زاویه 0 درجه موقعیت ساعت 12 را روی صفحه ساعت نشان می دهد.

به عنوان مثال، برای منحنی کردن متن در یک چهارم بالای صفحه ساعت، از یک startAngle 335.0 و یک endAngle 45.0 استفاده کنید.

ویژگی های اختیاری

ویژگی های زیر اختیاری هستند:

direction

جهت نگارش متن را نشان می دهد:

  • CLOCKWISE (پیش فرض): نمایش متن در جهت عقربه های ساعت.
  • COUNTER_CLOCKWISE : نمایش متن در جهت خلاف جهت عقربه‌های ساعت.
align

تراز متن را در عنصر اصلی آن تعیین می کند:

  • START : تراز چپ یا بالا (تراز راست وقتی زبان فعلی از جهت متن RTL استفاده می کند)
  • CENTER : تراز وسط
  • END : تراز راست یا پایین (تراز چپ زمانی که زبان فعلی از جهت متن RTL استفاده می کند)

مقدار پیش فرض CENTER است.

ellipsis

یک مقدار بولی که نشان می دهد اگر متن خیلی طولانی است که در عنصر والد قرار نگیرد، بیضی نشان داده شود یا خیر. پیش فرض FALSE است.

عناصر درونی

عنصر Text می تواند شامل هر تعداد از عناصر داخلی زیر باشد:

{% کلمه به کلمه %} {% آخر کلمه %} {% کلمه به کلمه %} {% آخر کلمه %}