openAlertDialog (Client-API-Referenz)

  • Artikel

Zeigt einen Warnungsdialog an, der eine Nachricht und eine Schaltfläche enthält.

Syntax

Xrm.Navigation.openAlertDialog(alertStrings,alertOptions).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
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) Nummer. Höhe des Warnung-Dialogfelds in Pixeln.
- width: (Optional) Nummer. 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);
    }
);

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).