TextCircular

Chỉ định cấu hình văn bản tròn hoặc cong.

Ra mắt trong Wear OS 4.

Cú pháp

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

Thuộc tính

Phần tử TextCircular có các thuộc tính như sau. Một số thuộc tính là bắt buộc, trong khi các thuộc tính khác là không bắt buộc.

Thuộc tính bắt buộc

Các thuộc tính sau đây là bắt buộc:

centerX và centerY

Một cặp giá trị dấu phẩy động cho biết vị trí tâm của phần tử.

Các thuộc tính này có thể biến đổi.

width và height

Một cặp giá trị dấu phẩy động cho biết kích thước của phần tử.

startAngle và endAngle

Một cặp giá trị dấu phẩy động cho biết góc cạnh đầu của văn bản và góc cạnh kết thúc của văn bản, theo cách tương ứng. Góc 0 độ thể hiện vị trí 12 giờ trên mặt đồng hồ.

Ví dụ: để di chuyển văn bản xung quanh một phần tư trên cùng của mặt đồng hồ, hãy sử dụng startAngle của 335.0 và endAngle của 45.0.

Các thuộc tính này có thể biến đổi.

Thuộc tính không bắt buộc

Các thuộc tính sau đây là không bắt buộc:

direction

Cho biết hướng viết của văn bản:

  • CLOCKWISE (mặc định): Hiển thị văn bản theo chiều kim đồng hồ.
  • COUNTER_CLOCKWISE: Hiển thị văn bản ngược chiều kim đồng hồ.
align

Xác định cách căn chỉnh văn bản trong phần tử mẹ:

  • START: căn trái hoặc trên cùng (căn phải khi ngôn ngữ hiện tại sử dụng hướng văn bản RTL)
  • CENTER: căn giữa
  • END: căn phải hoặc căn dưới cùng (căn trái khi ngôn ngữ hiện tại sử dụng hướng văn bản RTL)

Giá trị mặc định là CENTER.

ellipsis

Giá trị boolean cho biết liệu có hiển thị dấu ba chấm hay không trong trường hợp văn bản quá dài, không vừa với phần tử mẹ. Mặc định là FALSE.

Phần tử bên trong

Phần tử Text có thể chứa tuỳ ý số lượng phần tử bên trong sau đây: