顯示包含訊息和兩個按鈕的確認對話方塊。
語法
Xrm.Navigation.openConfirmDialog(confirmStrings,confirmOptions).then(successCallback,errorCallback);
參數
備註
當你啟用 新造型時,如果沒有設定對話框選項的 高度 值,對話框的高度會自動調整大小。
| 名稱 | 類型 | 為必填項目 | Description |
|---|---|---|---|
confirmStrings |
確認弦 | Yes | 確認對話框中使用的字串。 |
confirmOptions |
確認選項 | 否 | 確認對話框的高度與寬度選項。 |
successCallback |
函式 | 否 | 在關閉確認對話方塊時,按一下對話方塊右上角的確認、取消或 X 來執行的函數。 會傳遞具有 已確認 (布林值) 屬性的物件,指出是否已按一下確認按鈕以關閉對話方塊。 |
errorCallback |
函式 | 否 | 作業失敗時要執行的函式。 |
確認字串
| 名稱 | 類型 | Description |
|---|---|---|
cancelButtonLabel |
String | (可選)取消按鈕的標籤。 如果您未指定取消按鈕標籤,則 會使用 [取消] 作為按鈕標籤。 |
confirmButtonLabel |
String | (可選)確認按鈕標籤。 如果您未指定確認按鈕標籤,則會使用 [確定 ] 作為按鈕標籤。 |
subtitle |
String | (可選)確認對話框中顯示的副標題。 |
text |
String | 確認對話框中顯示的訊息。 |
title |
String | (可選)標題會顯示在確認對話框中。 |
確認選項
| 名稱 | 類型 | Description |
|---|---|---|
height |
數量 | (可選)確認對話高度(像素)。 啟用 新外觀 後,如果你沒設定 height 對話選項的值,對話高度會自動調整大小。 |
width |
數量 | (可選)確認對話框的寬度(像素)。 |
Example
下列程式碼範例會顯示確認對話方塊。 它會在主控台記錄適當的訊息,取決於使用者選擇確認或取消/X 來關閉對話框。
const confirmStrings = {
text: "This is a confirmation.",
title: "Confirmation Dialog"
};
const confirmOptions = { height: 200, width: 450 };
Xrm.Navigation.openConfirmDialog(confirmStrings, confirmOptions).then(({ confirmed }) => {
if (confirmed) {
console.log("Dialog closed using OK button.");
} else {
console.log("Dialog closed using Cancel button or X.");
}
});