[本文章是發行前版本文件，且隨時可能變更。]
用來分組內容的控制項。
重要
- 這是實驗性功能。
- 預覽功能不供生產時使用，而且可能功能受限。 這些功能是在正式發行前先行推出，讓客戶能夠搶先體驗並提供意見反應。
描述
對話方塊 (Dialog) 一種暫時的快顯視窗，可讓您從頁面或應用程式取得焦點，並需要人員與其互動。 其主要是用來確認動作，例如，刪除檔案或要求人員進行選擇。
此畫布元件會模仿 Fluent UI Dialog 控制項的樣式和行為。 請參閱文件以了解最佳做法。
查看 Creator Kit GitHub 存放庫中的元件。
屬性
索引鍵屬性
| 屬性 | 描述 |
|---|---|
Buttons |
定義按鈕的資料集 (在按鈕屬性中了解更多)。 |
Title |
標題區段中顯示的文字。 |
OverlayColor |
顯示在重疊區域中的色彩。 |
DialogWidth |
Dialog 的寬度 (不要將它與控制項寬度混淆，控制項寬度必須跨越應用程式寬度)。 |
DialogHeight |
Dialog 的高度 (不要將它與控制項高度混淆，控制項寬度必須跨越應用程式高度)。 |
SubTitle |
標題下顯示的文字。 |
按鈕屬性
| 屬性 | 描述 |
|---|---|
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 控制本身 (或其所在的表面) 可見。 將該變數指派給對話方塊的可見性屬性。 若要在顯示對話方塊後將其隱藏，請更新選取關閉圖示時觸發的重設屬性上的變數。
以下顯示的 Power Fx 公式，用於在應用程式某處的另一個元件上的動作公式中打開對話方塊 (例如，按鈕的 OnSelect 屬性)：
UpdateContext({ showHideDialog: true })
以下是在對話方塊的 OnCloseSelect 屬性中關閉對話方塊的 Power Fx 公式：
UpdateContext({ showHideDialog: false })
將變數指派給對話方塊的 Visible 屬性：
showHideDialog
設定按鈕動作
在對話方塊的 OnButtonSelect 屬性中，根據 If() 文字值在 Switch() 或 Self.SelectedButton.Label 條件下提供動作以定義動作。 視動作而定，在動作完成後，也可能會關閉對話方塊。
If( Self.SelectedButton.Label = "Send",
Notify("Email Sent")
);
UpdateContext({ showHideDialog: false })
限制
此畫布元件只能在畫布應用程式和自訂頁面中使用。