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