Thành phần kiểm soát Dialog (thử nghiệm)

[Bài viết này là tài liệu trước khi phát hành và có thể thay đổi.]

Một thành phần kiểm soát dùng để nhóm nội dung.

Quan trọng

• Đây là một tính năng thử nghiệm.
• Các tính năng thử nghiệm không được dùng cho sản xuất và có thể có chức năng bị hạn chế. Những tính năng này khả dụng trước khi có bản phát hành chính thức để khách hàng có thể truy cập sớm và cung cấp phản hồi.

Description

Hộp thoại (Dialog) là một cửa sổ bật lên tạm thời lấy tiêu điểm từ trang hoặc ứng dụng và yêu cầu mọi người tương tác với nó. Hộp thoại chủ yếu được dùng để xác nhận các hành động, chẳng hạn như xóa tệp hoặc yêu cầu mọi người lựa chọn.

Thành phần canvas này bắt chước kiểu và tính chất của thành phần kiểm soát Dialog trong Fluent UI. Xem hướng dẫn sử dụng để biết các phương pháp hay nhất.

Xem thành phần trong kho lưu trữ GitHub của Bộ công cụ dành cho người tạo.

Thuộc tính

Thuộc tính khóa

Thuộc tính	Description
Buttons	Tập dữ liệu xác định các nút (xem thuộc tính bên dưới)
Title	Văn bản hiển thị trong phần tiêu đề
OverlayColor	Màu hiển thị trong vùng lớp phủ
DialogWidth	Chiều rộng của hộp thoại (đừng nhầm lẫn với chiều rộng của thành phần điều khiển, không sẽ kéo dài chiều rộng của ứng dụng)
DialogHeight	Chiều cao của hộp thoại (đừng nhầm lẫn với chiều cao của thành phần điều khiển, không sẽ kéo dài chiều cao ứng dụng).
SubTitle	Văn bản hiển thị bên dưới tiêu đề

Thuộc tính Buttons

Thuộc tính	Description
Label	Nhãn hiển thị trên nút.
ButtonType	Phép liệt kê xác định kiểu của nút. Chọn giữa Standard và Primary.

Table(
    {
        Label: "Cancel", 
        ButtonType:'Microsoft.CoreControls.Button.ButtonType'.Standard 
    },{
        Label: "Ok", 
        ButtonType:'Microsoft.CoreControls.Button.ButtonType'.Primary
    }
)

Thuộc tính kiểu

Thuộc tính	Description
Theme	Đối tượng chủ đề. Xem chủ đề để biết hướng dẫn về cách đặt cấu hình.

Để định dạng, hãy xem hướng dẫn trong phần nội dung bảng điều khiển Định dạng của Bảng điều khiển.

Thuộc tính sự kiện

Thuộc tính	Description
OnCloseSelect	Biểu thức hành động được thực thi khi nút đóng được chọn.
OnButtonSelect	Biểu thức hành động được thực thi khi nút đóng được chọn.

Hành vi

Đặt cấu hình khả năng hiển thị Hộp thoại

Hiển thị chính thành phần kiểm soát Dialog(hoặc giao diện chứa thành phần này) khi biến kiểu Boolean (true/false) thay đổi thành giá trị true và gán biến đó cho thuộc tính khả năng hiển thị của hộp thoại. Sau khi hộp thoại hiển thị, bạn có thể ẩn hộp thoại bằng cách cập nhật biến trên thuộc tính đặt lại, được kích hoạt khi biểu tượng đóng được chọn.

Phần sau minh họa công thức Power Fx để mở hộp thoại trong một công thức hành động trên một thành phần khác ở đâu đó trong ứng dụng (ví dụ: thuộc tính OnSelect của nút):

UpdateContext({ showHideDialog: true })

Dưới đây là công thức Power Fx để đóng hộp thoại trong thuộc tính OnCloseSelect của hộp thoại:

UpdateContext({ showHideDialog: false })

Gán biến cho thuộc tính Visible của hộp thoại:

showHideDialog

Đặt cấu hình hành động của nút

Trong thuộc tính OnButtonSelect của hộp thoại, hãy cung cấp các hành động trong điều kiện If() hoặc Switch() dựa trên giá trị văn bản Self.SelectedButton.Label để xác định hành động. Tùy thuộc vào hành động, bạn cũng có thể đóng hộp thoại sau khi hoàn thành hành động.

    If( Self.SelectedButton.Label = "Send", 
        Notify("Email Sent")
    );
    UpdateContext({ showHideDialog: false })

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.