Dialog 對照 (實驗性)

[本文章是發行前版本文件，且隨時可能變更。]

用來分組內容的控制項。

重要

• 這是實驗性功能。
• 實驗性功能不供生產時使用，而且可能功能受限。 這些功能是在正式發行前先行推出，讓客戶能夠搶先體驗並提供意見反應。

描述

對話方塊 (Dialog) 一種暫時的快顯視窗，可讓您從頁面或應用程式取得焦點，並需要人員與其互動。 其主要是用來確認動作，例如，刪除檔案或要求人員進行選擇。

此畫布元件會模仿 Fluent UI Dialog 控制項的樣式和行為。 如需最佳做法，請參閱文件。

在 Creator Kit GitHub 儲存庫中查看元件。

內容

索引鍵屬性

屬性	描述
Buttons	定義按鈕的資料集 (請參閱以下屬性)
Title	標題區段中顯示的文字
OverlayColor	顯示在重疊區域中的色彩
DialogWidth	Dialog 的寬度 (不要將它與控制項寬度混淆，控制項寬度必須跨越應用程式寬度)
DialogHeight	Dialog 的高度 (不要將它與控制項高度混淆，控制項寬度必須跨越應用程式高度)。
SubTitle	標題下顯示的文字

Buttons 性能

屬性	描述
Label	按鈕上顯示的標籤。
ButtonType	用於確定按鈕樣式的列舉。 在 Standard 和 Primary 之間進行選擇。

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

樣式屬性

屬性	描述
Theme	主題物件。 有關如何設定的指南，請參閱佈景主題。

若要設定格式，請參閱面板的格式面板內容區段中的指南。

事件屬性

屬性	描述
OnCloseSelect	當選取 [關閉] 按鈕時執行的動作運算式。
OnButtonSelect	當選取 [關閉] 按鈕之一時執行的動作運算式。

行為

設定 Dialog 可見度

當布林值 (True/False) 類型變數變更為 True 時，讓 Dialog 控制項本身 (或它所在的介面) 可見，並將該變數指派給對話方塊的可見度屬性。 顯示對話方塊之後，您可以透過更新 reset 屬性上的變數來隱藏對話方塊，該屬性在選取關閉圖示時觸發。

以下顯示的 Power Fx 公式，用於在應用程式某處的另一個元件上的動作公式中打開對話方塊 (例如，按鈕的 OnSelect 屬性)：

UpdateContext({ showHideDialog: true })

以下是在對話方塊的 OnCloseSelect 屬性中關閉對話方塊的 Power Fx 公式：

UpdateContext({ showHideDialog: false })

將變數指派給對話方塊的 Visible 屬性：

showHideDialog

設定按鈕動作

在對話方塊的 OnButtonSelect 屬性中，根據 Self.SelectedButton.Label 文字值在 If() 或 Switch() 條件下提供動作以定義動作。 視動作而定，在動作完成後，也可能會關閉對話方塊。

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

限制

此畫布元件只能在畫布應用程式和自訂頁面中使用。