openConfirmDialog (Client-API-Referenz)
Zeigt ein Bestätigungsdialogfeld an, das eine Nachricht und zwei Schaltflächen enthält.
Syntax
Xrm.Navigation.openConfirmDialog(confirmStrings,confirmOptions).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 |
---|---|---|---|
confirmStrings |
Object | Ja | Die im Dialogfeld Bestätigung verwendeten Zeichenfolgen. Das Objekt enthält die folgenden Werte: - cancelButtonLabel : (optional) Zeichenfolge. Die Abbrechen-Schaltflächenbeschriftung. Wenn Sie nicht die Beschriftung der Abbrechen-Schaltfläche angeben, wird Abbrechen als Beschriftung der Schaltfläche verwendet.- confirmButtonLabel : (optional) Zeichenfolge. Die Bestätigensschaltflächenbeschriftung. Wenn Sie nicht die Beschriftung der Bestätigen-Schaltfläche angeben, wird OK als Beschriftung der Schaltfläche verwendet.- subtitle : (optional) Zeichenfolge. Der Untertitel zum Anzeigen im Dialogfeld Bestätigen.- text : Zeichenfolge. Die im Bestätigungsdialog anzuzeigende Nachricht.- title : (optional) Zeichenfolge. Der im Bestätigungsdialog anzuzeigende Titel. |
confirmOptions |
Object | Nein | Die Höhen- und Breitenoptionen für Bestätigen-Dialogfeld. Das Objekt enthält die folgenden Werte: - height : (optional) Zahl. Höhe des Bestätigung-Dialogfelds in Pixeln.- width : (optional) Zahl. Breite des Bestätigung-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 Bestätigungsdialogfeld geschlossen ist, indem das bestätigte, Löschen oder in der X rechten Ecke des Dialogfelds. Ein Objekt mit dem Attribut Bestätigt (boolesch) wird übergeben, das angibt, ob die Bestätigen-Schaltfläche angeklickt wurde, um das Dialogfeld zu schließen. |
errorCallback |
function | Nein | Eine auszuführende Funktion, wenn der Vorgang fehlgeschlagen ist. |
Beispiel
Im folgenden Codebeispiel wird ein Bestätigungsdialogfeld angezeigt. Entsprechende Nachricht wird in der Konsole protokolliert, je nachdem, ob Sie bestätigen oder cancel/X geklickt wurde, um das Dialogfeld zu schließen.
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.");
});