[本文章是發行前版本文件，且隨時可能變更。]
用來分組內容的控制項。
Important
- 這是實驗性功能。
- 預覽功能不供生產時使用，而且可能功能受限。 這些功能是在正式發行前先行推出，讓客戶能夠搶先體驗並提供意見反應。
Description
對話方塊是一種暫時的快顯視窗，會從頁面或應用程式中取得焦點，要求使用者與之互動。 其主要是用來確認動作，例如，刪除檔案或要求人員進行選擇。
此畫布元件會模仿 Fluent UI Dialog 控制項的樣式和行為。 請參閱文件以了解最佳做法。
查看 Creator Kit GitHub 存放庫中的元件。
屬性
關鍵屬性
| 房產 | Description |
|---|---|
Buttons |
定義按鈕的資料集 (在按鈕屬性中了解更多)。 |
Title |
標題區段中顯示的文字。 |
OverlayColor |
顯示在重疊區域中的色彩。 |
DialogWidth |
Dialog 的寬度 (不要將它與控制項寬度混淆，控制項寬度必須跨越應用程式寬度)。 |
DialogHeight |
對話方塊的高度 (不要將其與控制項高度混淆，此高度必須跨越應用程式高度)。 |
SubTitle |
標題下顯示的文字。 |
按鈕屬性
| 房產 | Description |
|---|---|
Label |
按鈕上顯示的標籤。 |
ButtonType |
決定按鈕樣式的列舉。 在 Standard 和 Primary 之間進行選擇。 |
Table(
{
Label: "Cancel",
ButtonType:'Microsoft.CoreControls.Button.ButtonType'.Standard
},{
Label: "Ok",
ButtonType:'Microsoft.CoreControls.Button.ButtonType'.Primary
}
)
樣式屬性
| 房產 | Description |
|---|---|
Theme |
主題物件。 進一步了解主題。 |
如需進一步了解格式化，請參閱面板的格式化面板內容一節。
事件屬性
| 房產 | Description |
|---|---|
OnCloseSelect |
當選擇關閉按鈕時執行的動作表達式。 |
OnButtonSelect |
當選取一個動作按鈕時執行的動作運算式。 |
行為
設定對話框可見度
當布林值 (true/false) 變數變更為 true 時，使 Dialog 控制項本身 (或其所在的介面) 可見。 將該變數指派給對話方塊的可見性屬性。 若要在顯示對話方塊後將其隱藏，請在選取關閉圖示時觸發的重設屬性上更新變數。
以下顯示可在應用程式某處其他元件的動作公式中開啟對話方塊的 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 })
Limitations
此畫布元件只能在畫布應用程式和自訂頁面中使用。