Vùng giới hạn chức năng

Vùng giới hạn chức năng (Complication bounding area) dùng để xác định khu vực kết xuất cho Chức năng (Complication). Một đường viền của khu vực giới hạn sẽ xuất hiện trong trình chỉnh sửa mặt đồng hồ. Mọi nội dung nằm ngoài phạm vi giới hạn sẽ bị cắt mất.

Khu vực giới hạn cũng xác định khu vực mà người dùng có thể chọn chức năng từ mặt đồng hồ.

Ra mắt trong Wear OS 4.

BoundingBox

Phần tử BoundingBox xác định vùng giới hạn hình chữ nhật cho chức năng.

Cú pháp

<BoundingBox x="integer" y="integer" width="integer" height="integer"
                outlinePadding="float" />

Thuộc tính

Phần tử BoundingBox có các thuộc tính như sau:

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

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

x, y, width, height

Tập hợp số nguyên cho biết kích thước và vị trí của phần tử.

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:

outlinePadding

Một số thực chỉ định khoảng đệm để áp dụng cho bên ngoài vùng giới hạn. Tính năng này dùng để tạo đường viền lớn hơn trong trình chỉnh sửa mặt đồng hồ. Giá trị mặc định là: 0

BoundingRoundBox

Phần tử BoundingRoundBox xác định vùng giới hạn hình chữ nhật với góc bo tròn cho chức năng.

Cú pháp

<BoundingRoundBox x="integer" y="integer" width="integer" height="integer"
                outlinePadding="float" cornerRadius="float" />

Thuộc tính

Phần tử BoundingRoundBox có các thuộc tính như sau:

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

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

x, y, width, height

Tập hợp số nguyên cho biết kích thước và vị trí của phần tử.

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:

cornerRadius

Bán kính của một hình tròn. Giá trị này xác định phạm vi bo tròn các góc của hình chữ nhật.

outlinePadding

Một số thực chỉ định khoảng đệm để áp dụng cho bên ngoài vùng giới hạn. Tính năng này dùng để tạo đường viền lớn hơn trong trình chỉnh sửa mặt đồng hồ. Giá trị mặc định là: 0

BoundingOval

Phần tử BoundingOval xác định một vùng giới hạn tròn cho chức năng.

Cú pháp

<BoundingOval x="integer" y="integer" width="integer" height="integer"
                outlinePadding="float" />

Thuộc tính

Phần tử BoundingOval có các thuộc tính như sau:

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

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

x, y, width, height

Tập hợp số nguyên cho biết kích thước và vị trí của phần tử.

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:

outlinePadding

Một số thực chỉ định khoảng đệm để áp dụng cho bên ngoài vùng giới hạn. Tính năng này dùng để tạo đường viền lớn hơn trong trình chỉnh sửa mặt đồng hồ. Giá trị mặc định là: 0

BoundingArc

Phần tử BoundingArc xác định một vùng giới hạn có dạng vòng cung cho chức năng này.

Cú pháp

<BoundingArc centerX="float" centerY="float" width="float"
                height="float" thickness="float" isRoundEdge="boolean"
                startAngle="float" endAngle="float"
                direction="CLOCKWISE | COUNTER_CLOCKWISE"
                outlinePadding="float" />

Thuộc tính

Phần tử BoundingArc có các thuộc tính như sau:

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

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

centerX, centerY, width, height

Tập hợp các thuộc tính giúp xác định hình bầu dục chứa vòng cung này. Vòng cung được căn chỉnh để vừa với hình bầu dục được chỉ định. Tất cả thuộc tính được định nghĩa là số thực.

thickness

Độ dày của cung tròn được biểu diễn bằng số thực.

startAngle

Góc bắt đầu (tính bằng độ) khi vòng cung bắt đầu. Góc 0 độ tương ứng với vị trí 12 giờ trên đồng hồ.

endAngle

Góc kết thúc, là điểm kết thúc của vòng cung.

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:

isRoundEdge

Xác định xem hình mũ ở cuối vòng cung phẳng hay tròn. Giá trị mặc định là FALSE.

direction

Hướng quay của vòng cung. Giá trị mặc định là CLOCKWISE.

outlinePadding

Một số thực chỉ định khoảng đệm để áp dụng cho bên ngoài vùng giới hạn. Tính năng này dùng để tạo đường viền lớn hơn trong trình chỉnh sửa mặt đồng hồ. Giá trị mặc định là 0