openAlertDialog (Client-API-Referenz)
Zeigt einen Warnungsdialog an, der eine Nachricht und eine Schaltfläche enthält.
Syntax
Xrm.Navigation.openAlertDialog(alertStrings,alertOptions).then(successCallback,errorCallback);
Parameter
Anmerkung
Wenn das neue Design aktiviert ist, wird die Dialoghöhe automatisch angepasst, wenn Sie den Wert height der Dialogoptionen nicht festlegen.
Name | Type | Erforderlich | Beschreibung |
---|---|---|---|
alertStrings |
Object | Ja | Die im Dialogfeld Warnung verwendeten Zeichenfolgen. Das Objekt enthält die folgenden Werte: - confirmButtonLabel : (optional) Zeichenfolge. Die Bestätigensschaltflächenbeschriftung. Wenn Sie nicht die Beschriftung der Schaltfläche angeben, wird OK als Beschriftung der Schaltfläche verwendet.- Text: Zeichenfolge. Die im Dialogfeld anzuzeigende Nachricht. - title : (optional) Zeichenfolge. Der Titel des Warnungsdialogs. |
alertOptions |
Object | Nein | Die Höhen- und Breitenoptionen für Warnung-Dialogfeld. Das Objekt enthält die folgenden Werte: - height : (optional) Zahl. Höhe des Warnung-Dialogfelds in Pixeln.- width : (optional) Zahl. Breite des Warnung-Dialogfelds in Pixeln.Wenn das neue Design aktiviert ist, wird die Dialoghöhe automatisch angepasst, wenn Sie den Wert height der Dialogoptionen nicht festlegen. |
successCallback |
function | Nein | Ein Feature zum Ausführen, wenn das Warnung-Dialogfeld durch Klicken auf die Bestätigen-Schaltfläche geschlossen oder abgebrochen wird, indem ESC gedrückt wird. |
errorCallback |
function | Nein | Eine auszuführende Funktion, wenn der Vorgang fehlgeschlagen ist. |
Beispiel
Der folgende Warnung-Beispielcode zeigt ein Dialogfeld an. Wenn Sie im Warnungsdialog auf die Schaltfläche Ja klicken oder den Warnungsdialog durch Drücken von ESC abbrechen, wird die close
-Funktion aufgerufen:
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);
}
);