openConfirmDialog (用戶端 API 參考)

顯示包含訊息和兩個按鈕的確認對話方塊。

語法

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.");
  }
});

Xrm.導航