Eventhandler
Events (Ereignisse) sind Funktionen (mit reservierten Namen), die ausgeführt werden, sobald das Ereignis eintritt. Wenn wir nun einen bestimmten Code ausführen möchten, sobald der Spieler mit einem Gegner kollidiert, benutzen wir den Event-Handler onCollision() gefolgt von einem Codeblock mit unserem Code. Hier die Event-Handler im Überblick.
| Handler | Beschreibung |
|---|---|
| onclick(e) | Wird immer dann aufgerufen, wenn das Objekt angeklickt wird. |
| onUpdate() | Wird mit jedem Frame aufgerufen. |
| onInit() | Wird einmalig bei der Initialisierung des Objektes aufgerufen. |
| onMouseDown(e) | Wird aufgerufen, wenn eine Maustaste gedrückt wurde. |
| onMouseMove(e) | Wird aufgerufen, wenn die Maus bewegt wird. |
| onMouseUp(e) | Wird aufgerufen, wenn eine Maustaste losgelassen wird. |
| onMouseWheel(e) | Wird aufgerufen, wenn das Mausrad gedreht wird. Der Wert wird als Gleitkommazahl als 'mouseWheelDelta(e)' gespeichert. + 1 Für eine “Einkerbung“ nach oben, -1 für eine Einkerbung nach unten. |
| onHoverBegin(e) | Wird ausgeführt, sobald man mit der Maus über das Objekt fährt. |
| onHoverEnd(e) | Wird ausgeführt, sobald der Mauszeiger das Objekt nicht mehr berührt. |
| onKeyChange(e) | Wird aufgerufen, wenn eine Taste gedrückt oder losgelassen wird. |
| onShow() | Spezielles Event, das ausgeführt wird wenn ein keyframe dargestellt wird. Nur für Keyframe-Scripts relevant. |
| onCollision(objectId) | Wird ausgeführt, wenn sich zwei Objekte berühren. Wenn es im Objekt-Script verwendet wird, wird die ID des Objektes übermittelt, mit dem es kollidiert. |
| onCollisionBegin(objectId) | Das Gleiche wie onCollision(), wird jedoch nur einmalig bei der ersten Kollision ausgeführt. |
| onCollisionEnd(objectId) | Das Gleiche wie onCollision(), wird jedoch erst ausgeführt, sobald die Kollision abgeschlossen ist. |
| onRender(layerId) | Wird ausgeführt, sobald ein Frame gerendert ist. Da die Szene mehrere Layer haben kann, wird die entsprechende LayerId als string Parameter geliefert. |
| onPhysicsContact(objectId) | Wird aufgerufen, sobald sich zwei „solid“ Objekte berühren. Die Funktion wird nur einmalig ausgeführt, bis sich die Objekte nicht mehr berühren. |
| onPhysicsSeparate(objectId) | Wird aufgerufen, sobald sich zwei “solid” Objekte nicht mehr berühren. Diese Funktion wird nur einmalig ausgeführt, bis sich die Objekte wieder berühren. |
| onPathBlocked() | Wird ausgeführt, wenn ein Objekt einem “path” folgt, dessen Weg versperrt ist. |
| onPathComplete() | Wird ausgeführt, sobald das Objekt das Ziel von seinem “path” erreicht hat. |
| onInputBegin() | Wird ausgeführt, sobald ein Objekt eine Texteingabe empfängt. |
| onInputChange() | Wird ausgeführt, sobald sich ein Objekt während der Texteingabe ändert. |
| onInputEnd() | Wird ausgeführt, sobald die Texteingabe beendet ist. |
| onEffectObjectEnter(effectObjectId) | Wird aufgerufen, sobald ein Objekt einen „Effectcube“ mit “Volumen” betritt. |
| onEffectObjectLeave(effectObjectId) | Wird aufgerufen, sobald ein Objekt einen Effectcube verlässt. |
| onExitRequest(e) | Wird aufgerufen, sobald die Anwendung geschlossen wird(nicht bei Browserprogrammen). Setze system.exitAbort auf true um diesen Prozess zu unterbrechen und das Programm weiterlaufen zu lassen. |
| onBackgroundLoadComplete(e) | Wird aufgerufen, sobald eine Datei im Hintergrund fertig geladen wurde. Die Event-Struktur „e“ enthält die members „loadFilename“ und „loadSuccess“. „loadFilename“ enthält den Dateinamen und „loadSuccess“ enthält einen booleschen Wert, der auf wahr gesetzt wird, sobald die Datei fertig geladen ist, bzw. auf falsch falls die Datei nicht geladen werden konnte. |
| onControlNotify(info) | Dieses Event wird aufgerufen, wenn das Objekt einem „dxcontrol“ angehängt wurde und das Modul die Funktion „scene.controlNotify(info)“ ausführt, um eine Veränderung zu signalisieren. Die Info stellt optionale Informationen zur Verfügung. |
| onModuleNotify(info) | Dieses Event wird aufgerufen, wenn das Objekt einem „dxmodule“ angehängt wurde und das Modul die Funktion „scene.controlNotify(info)“ ausführt, um eine Veränderung zu signalisieren. Die Info stellt optionale Informationen zur Verfügung. |
| onVariableSet(variableId) | Dieses Event wird immer dann ausgeführt, wenn eine Variable via „script.xxx“ geändert wurde. Die „variableId“ übermittelt die Id der Variable als String. |
| onCopyData() | Wird ausgeführt, sobald ein “Programm zu Programm”-Datenblock ankommt.(Unter Windows ist das eine WM_COPYDATA Nachricht). Die Daten selbst können in system.copyData (ByteData) gefunden werden. |
| onInitAfterChild() | Wird ausgeführt, sobald das Dokument zum ersten Mal Initialisiert wird, aber erst nachdem die Unterobjekte Ihre onInit() Funktionen ausgeführt haben. |
| onTimer(timerId) | Wird ausgeführt, sobald ein Timer ausgelöst wird. Ein Timer kann in einem Dokument-, einem Szene- oder einem Objekt-Script mit der setTimer(id, delay) Methode erstellt werden. |
