顯示包含訊息和按鈕的警示對話方塊。
語法
Xrm.Navigation.openAlertDialog(alertStrings,alertOptions).then(successCallback,errorCallback);
參數
備註
啟用 新外觀 後,如果您未設定對話方塊選項的 高度 值,對話方塊高度會自動調整大小。
| 名稱 | 類型 | 為必填項目 | Description |
|---|---|---|---|
alertStrings |
物體 | Yes | 要在警示對話方塊中使用的字串。 物件包含下列值: - confirmButtonLabel: (選擇性) 字串。 確認按鈕標籤。 如果您未指定按鈕標籤,則會使用 [確定 ] 作為按鈕標籤。- text:字串。 要在警示對話方塊中顯示的訊息。 - title: (選擇性) 字串。 警示對話方塊的標題。 |
alertOptions |
物體 | 否 | 警示對話方塊的高度和寬度選項。 物件包含下列值: - height:(選用)數字。 警示對話方塊的高度 (以像素為單位)。- width:(選用)數字。 警示對話方塊像素的寬度。啟用 新外觀 後,如果您未設定 height 對話方塊選項的值,對話方塊高度會自動調整大小。 |
successCallback |
函式 | 否 | 當警報對話方塊關閉時執行的功能,按一下確認按鈕或按 ESC 取消。 |
errorCallback |
函式 | 否 | 作業失敗時要執行的函式。 |
Example
下列範例程式碼會顯示警示對話方塊。 按一下警示對話方塊中的 「是」 按鈕,或按 ESC 鍵取消警示對話方塊,會呼叫函數 close :
var alertStrings = { confirmButtonLabel: "Yes", text: "This is an alert.", title: "Sample title" };
var alertOptions = { height: 120, width: 260 };
Xrm.Navigation.openAlertDialog(alertStrings, alertOptions).then(
function (success) {
console.log("Alert dialog closed");
},
function (error) {
console.log(error.message);
}
);