Điều khiển ProgressIndicator

Một thành phần kiểm soát được dùng để tạo trải nghiệm tải.

Lưu ý

Toàn bộ tài liệu và mã nguồn có trong kho lưu trữ thành phần mã GitHub.

Description

Các chỉ báo tiến trình được sử dụng để hiển thị trạng thái hoàn thành của một hoạt động kéo dài hơn 2 giây. Nếu không thể xác định trạng thái của tiến trình, hãy sử dụng Spinner hoặc sử dụng loại Indeterminate Indicator. Các chỉ báo tiến độ có thể xuất hiện trong bảng điều khiển mới, trong cửa sổ thả xuống, bên dưới giao diện người dùng đã bắt đầu hoạt động hoặc thậm chí chúng có thể thay thế giao diện người dùng ban đầu miễn là giao diện người dùng đó có thể quay lại nếu bạn hủy hoặc dừng hoạt động.

Thành phần mã này cung cấp một trình bao bọc xung quanh điều khiển Fluent UI ProgressIndicator để sử dụng trong canvas & các trang tùy chỉnh. Xem hướng dẫn sử dụng thành phần để biết các phương pháp hay nhất.

Thuộc tính

Thuộc tính khóa

Thuộc tính	Description
Label	Nhãn tùy chọn cho spinner.
Percentage Complete	Tỷ lệ phần trăm hoạt động đã hoàn thành, trên thang điểm từ 0 đến 1. Nếu không được đặt, Chỉ báo không xác định sẽ được hiển thị.
TypeOfIndicator	Chỉ định loại kiểu chỉ báo. Lựa chọn: Default Indicator hoặc IndeterminateIndicator
HideProgressState	Chỉ định đúng để ẩn trạng thái tiến trình
BarHeight	Chỉ định chiều cao của thanh nếu có

Thuộc tính kiểu

Thuộc tính	Description
Theme	Chấp nhận chuỗi JSON được tạo bằng cách sử dụng Fluent UI Theme Designer (windows.net). Để trống phần này sẽ sử dụng chủ đề mặc định được xác định bởi Power Apps. Xem chủ đề để biết hướng dẫn về cách đặt cấu hình.
AccessibilityLabel	Nhãn aria cho trình đọc màn hình

Hành vi

Hiển thị trạng thái tải

Hiển thị tùy chọn kiểm soát ProgressIndicator (hoặc bề mặt mà nó nằm bên trong) khi một quy trình bắt đầu, sau đó cập nhật một biến có giá trị khi các phân đoạn của quy trình hoàn tất. Ẩn nó khi quy trình không đầy đủ. Sử dụng một biến để kiểm soát khả năng hiển thị của kiểm soát và cập nhật các giá trị giữa các khối mã chính của quy trình cần được chỉ định.

UpdateContext({ var_showProgress: true , var_progressValue: 0 });

/* Some code ... */

UpdateContext({ var_progressValue: 25 });

/* Some code ... */

UpdateContext({ var_progressValue: 50 });

/* Some code ... */

UpdateContext({ var_progressValue: 75 });

/* Some code ... */

UpdateContext({ var_progressValue: 100 });

Notify("Successfully completed process", NotificationType.Success);

UpdateContext({ var_showProgress: false });

Cung cấp biến var_showProgress làm giá trị cho thuộc tính Visible của ProgressIndicator (hoặc bề mặt chứa nó) và gán cho biến var_progressValue cho thuộc tính Value.

Giới hạn

Chỉ có thể sử dụng thành phần canvas này trong ứng dụng canvas và trang tùy chỉnh.