openConfirmDialog (Client-API-Referenz)

  • Artikel

Zeigt ein Bestätigungsdialogfeld an, das eine Nachricht und zwei Schaltflächen enthält.

Syntax

Xrm.Navigation.openConfirmDialog(confirmStrings,confirmOptions).then(successCallback,errorCallback);

Parameter

Hinweis

Wenn das neue Design aktiviert ist, wird die Dialoghöhe automatisch angepasst, wenn Sie den Wert Höhe der Dialogoptionen nicht festlegen.

Name des Dataflows 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) Nummer. Höhe des Bestätigung-Dialogfelds in Pixeln.
- width: (Optional) Nummer. Breite des Bestätigung-Dialogfelds in Pixeln.

Wenn das neue Design aktiviert ist, wird die Dialoghöhe automatisch angepasst, wenn Sie den Wert Höhe 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.");
});

Xrm.Navigation

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).