onCanCancel (ModalDialog)
Einleitung
Das onCanCancel-Event ermöglicht es, das Schließen des Dialoges beim Drücken der ESC-Taste oder Klicken des X-Symbols (enaio® client) durch den Benutzer zu verhindern. Hier können Sie entsprechende Rückfragen an den Benutzer erstellen, falls eine Speicherung der Daten in das Datenblatt zu diesem Zeitpunkt nicht möglich ist.
Verfügbar: ab enaio® webclient 11.10.7
Beispiel
Das Event sollte in die Haupt-JS-Datei des externen Projekts integriert werden, nicht in die enaio®-Skripte. Zunächst wird der "Wert" deklariert, dann der Methode registerOnCanCancelCallback() zugewiesen. Dieser "Wert" kann später in anderen Funktionen oder Events dynamisch geändert werden. Er ist über den JavaScript Getter "Object Accessor" in der registerOnCanCancelCallback()-Funktion zugänglich. Dies ermöglicht eine flexible Handhabung und Aktualisierung des "Wertes" nach Bedarf in der Anwendung.
Beispiel onCanCancel event registration (TypeScript)
lib.registerOnCanCancelCallback(() => {
if (myDecisionMakingFunction()) {
return 1; // Modal dialog will be closed
}
return 2; // Modal dialog stays open
});Event-Properties
Der Event-Handler kann zu einem beliebigen Zeitpunkt an der Kommunikationsbibliothek registriert werden und wird ab diesem dann beim Drücken der ESC-Taste bzw. durch Klicken des Schließen-Symbols durch den Benutzer aufgerufen. Ist kein Event-Handler registriert, wird automatisch der Rückgabewert 1 angenommen und der modale Dialog wird direkt geschlossen. Soll der modale Dialog geöffnet bleiben, und das Drücken der ESC-Taste bzw. das Klicken des Schließen-Symbols eine andere Wirkung haben, so muss der Event-Handler den Wert 2 zurückgeben.