verbindet einen Handler mit einem internen Event des dhtmlxScheduler
name | SchedulerEventName | der Name des Events, case-insensitive |
handler | function | die Funktion, die das Event behandelt |
settings | object | optionale Einstellungen für den Event-Handler |
string | id die Kennung des verbundenen Event-Handlers |
scheduler.attachEvent("onEventSave",function(id,ev){
if (!ev.text) {
alert("Text darf nicht leer sein");
return false;
}
return true;
})
Mehrere Handler können an dasselbe Event angehängt werden und werden alle ausgeführt.
Wenn ein Handler false zurückgibt, wird die zugehörige Aktion verhindert.
Die Handler werden in der Reihenfolge aufgerufen, in der sie angehängt wurden.
Alle Event-Listener, die über event hinzugefügt wurden, werden automatisch entfernt, wenn der destructor aufgerufen wird.
Das settings-Objekt kann zwei Eigenschaften enthalten:
1. id - (string) eine eindeutige Kennung für den Event-Handler
Dies ermöglicht das einfache Entfernen eines bestimmten Handlers von einem Event:
scheduler.attachEvent("onClick", function(){
console.log("event click");
}, {id: "my-click"}); ... //später:
gantt.detachEvent("my-click");
2. once - (boolean) gibt an, ob das Event nur einmal ausgeführt werden soll
Setze dies auf true, um nur das erste Auftreten des Events zu behandeln, so:
scheduler.attachEvent("onClick", function(){
console.log("capture next event click");
return true;
}, {once: true});