DigitalClock

Đồng hồ số (digital clock) là vùng chứa các tập hợp chuỗi được định dạng nhằm tượng trưng cho giờ, phút và giây trong thời điểm hiện tại, tương ứng với giờ trên đồng hồ.

Ra mắt trong Wear OS 4.

Cú pháp

<DigitalClock x="integer" y="integer" width="integer" height="integer"
             pivotX="float" pivotY="float" angle="float-degrees" alpha="integer"
             scaleX="float" scaleY="float"
             renderMode="[SOURCE | MASK | ALL]"
             tintColor="argb-color | rgb-color">
    <!-- This is the only required inner element. -->
    <TimeText ... />
</DigitalClock>

Thuộc tính

Phần tử DigitalClock 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

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:

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

pivotX, pivotY

Điểm trung tâm hai chiều là điểm mà các phần tử xoay quanh. Cả hai đều là giá trị dấu phẩy động được điều chỉnh theo tỷ lệ để nằm trong khoảng $ [0, 1] $.

angle

Số độ (theo chiều kim đồng hồ) mà phần tử phải xoay quanh điểm trung tâm.

alpha

Thiết lập mức độ trong suốt mà phần tử này cần có. Giá trị 0 cho biết phần tử phải hoàn toàn trong suốt. Giá trị 255 cho biết phần tử phải hoàn toàn mờ đục.

scaleX

Hệ số tỷ lệ ngang dùng để áp dụng cho phần tử này.

scaleY

Hệ số tỷ lệ dọc dùng để áp dụng cho phần tử này.

renderMode

Kiểu hiển thị của phần tử. Các giá trị có thể là: SOURCE (mặc định), MASK hoặc ALL.

tintColor

Áp dụng bộ lọc màu phủ màu cho phần tử. Bạn phải chỉ định màu bằng cách sử dụng định dạng ARGB (#ff000000 = màu đen tuyền) hoặc định dạng RGB (#000000 = màu đen).

Phần tử bên trong

Phần tử DigitalClock có thể chứa các phần tử bên trong sau:

TimeText

Tập hợp chuỗi được định dạng để hiển thị giờ, phút và giây tương ứng với giờ đồng hồ hiện tại.

Localization

Gợi ý áp dụng ngôn ngữ bản địa khi kết xuất thời gian. Bạn có thể xem thêm thông tin trong tài liệu tham khảo về Localization.

Phần tử DigitalClock chỉ được chứa tối đa một phần tử Localization.

Variant

Cho phép thay đổi các thuộc tính của phần tử này khi thiết bị Wear OS ở chế độ môi trường xung quanh. Bạn có thể xem thêm thông tin trong tài liệu tham khảo về Variant.