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