12.4 Ereignismethoden 

Die Liste der Ereignismethoden (siehe Tabelle »Ereignismethoden« ab Seite 302) umfasst eine ganze Reihe an Objekten und deren zugehörige Methoden. Dabei sind einige Ereignismethoden polymorph. D.h. einige Methoden wie zum Beispiel onLoad existieren für unterschiedliche Objektarten mit abweichendem Verhalten.

Polymorphismus

Der Polymorphismus ist ein Verhalten der Objektorientierung. Dabei sind Objekte polymorph, wenn Sie gleichnamige Methoden besitzen, die unterschiedliche Fähigkeiten beschreiben. Die Methode fass funktioniert bei einem Menschen zum Beispiel anders als bei einem Hund.

Ereignismethoden entsprechen normalen Methoden, die Flash beim Eintritt des zugehörigen Ereignisses automatisch aufruft. Da es sich wie gesagt bei Ereignismethoden im Wesentlichen um Methoden handelt, verhält sich nicht nur die Erstellung identisch. Zusätzlich ist auch der Aufruf wie bei normalen Methoden erlaubt. Das folgende Beispiel arbeitet zum Beispiel die in der Ereignismethode onLoad angegebenen Anweisungen auch ohne das zugehörige Ereignis ab:

// onLoad funktioniert bei Ereignismethoden nicht immer korrekt (siehe Buch)

Ereignismethode als methode.fla

mcSeepferdchen.onLoad = function() {
   // Positioniere die Instanz
   trace("Init");
   this._x = 275;
   this._y = 200;
};
// "Händischer" Aufruf der Ereignismethode onLoad in der Instanz mcSeepferdchen
mcSeepferdchen.onLoad();
mcSeepferdchen.onEnterFrame = function() {
   // Skaliere Instanz abhängig vom Abstand zum Mauszeiger
   var deltax = this._parent._xmouse-this._x;
   var deltay = this._parent._ymouse-this._y;
   // Phytagoras zur Abstandsberechnung
   var entfernung = Math.sqrt(deltax*deltax+deltay*deltay);
   // Logarithmus für realistischeren Entfernungseindruck
   var scale = 100/Math.log(entfernung+10);
   this._xscale = scale;
   this._yscale = scale;
   // Bewege Instanz in Richtung Mauszeiger
   this._x = this._x+(this._parent._xmouse-this._x)/8;
   this._y = this._y+(this._parent._ymouse-this._y)/8;
};
mcSeepferdchen.onMouseDown = function() {
   // "Händischer" Aufruf der Ereignismethode onLoad in derselben Instanz
   this.onLoad();
};
// Alternative
mcSeepferdchen.onMouseDown = mcSeepferdchen.onLoad;

12.4.1 allowDomain 

Das Ereignis allowDomain wird immer dann ausgelöst, wenn eine Flash-Anwendung per lokaler Verbindung von einer anderen Anwendung angesprochen wird (siehe LocalConnection, Seite 623).

Bemerkung:

Syntax:

localConnectionInstanz.allowDomain(sendendeDomain);

12.4.2 allowInsecureDomain 

Das Ereignis allowInsecureDomain wird immer dann ausgelöst, wenn eine Flash-Anwendung aus einer sicheren Domain (https) per lokaler Verbindung von einer anderen Anwendung aus einer unsicheren Domain angesprochen wird (siehe LocalConnection, Seite 623).

Bemerkung:

Syntax:

localConnectionInstanz.allowInsecureDomain(sendendeDomain);

12.4.3 onActivity 

Das Ereignis onActivity wird immer dann ausgelöst, wenn ein angeschlossenes Mikrofon (Audioquelle) oder eine angeschlossene Kamera (Videoquelle) eine festgelegte Stufe an Veränderung überschreitet. Dies können Sie zum Beispiel für einen Bewegungsmelder oder ein Babyphon verwenden (siehe Camera (Seite 616) und Microphone (Seite 624)).

Bemerkung:

Syntax:

cameraInstanz.onActivity(aktivität);
microphoneInstanz.onActivity(aktivität);

Parameter:

Beispiel:

// Babyphone

onActivity.fla

meinMikrofon=Microphone.get();
// Bestimme Aktivitätsschwelle
meinMikrofon.setSilenceLevel(20,10);
meinMikrofon.onActivity = function(aktivitaet) {
   if (aktivitaet) {
      mcAnzeige.gotoAndStop(1);
   } else {
      mcAnzeige.gotoAndStop(2);
   }
}
// Audioquelle muss zur Bestimmung der Aktivität verwendet werden
_root.attachAudio(meinMikrofon);

12.4.4 onChanged 

Das Ereignis onChanged wird immer dann ausgelöst, wenn sich der Inhalt eines Textfeldes verändert. Dies können Sie zum Beispiel für die Überprüfung einer Formulareingabe verwenden (siehe Textfield, Seite 653).

Bemerkung:

Syntax:

textfeldInstanz.onChanged();

Beispiel:

meinTextfeld.onChanged=function () {

onChanged.fla

   trace("meinTextfeld wurde verändert!");
}

12.4.5 onClose 

Das Ereignis onClose wird immer dann ausgelöst, wenn ein Socket-Server die Verbindung zu einer XMLSocket-Instanz beendet (siehe XMLSocket, Seite 641).

Bemerkung:

Syntax:

xmlSocketInstanz.onChanged();

12.4.6 onConnect 

Das Ereignis onConnect wird immer dann ausgelöst, wenn ein Verbindungsaufbau zu einem Socket-Server erfolgreich war oder fehlgeschlagen ist (siehe XMLSocket, Seite 641).

Bemerkung:

Syntax:

xmlSocketInstanz.onConnect(erfolgreich);

Parameter:

12.4.7 onData 

Das Ereignis onData wird immer dann ausgelöst, wenn Daten geladen werden. Dies können Sie zum Beispiel für einen Preloader verwenden (siehe MovieClip, LoadVars, XML und XMLSocket in der Kurzreferenz).

Bemerkung:

Für loadVars ist diese Methode undokumentiert.

Syntax:

movieClipInstanz.onData();
loadVars.onData(daten);
textFieldStyleSheetInstanz.onData(daten);
xmlInstanz.onData(daten);
xmlSocketInstanz.onData(daten);

Parameter:

Beispiel:

XML.prototype.onData = function (daten) {

onData.fla

   if (daten == undefined) {
      this.onLoad(false);
   } else {
      this.parseXML(daten);
      this.loaded = true;
      this.onLoad(true);
   }
}

meinXML = new XML();
meinXML.onData = function (daten) {
   trace("Geladene Zeichenkette = " + daten);
}
meinXML.load("daten.txt");

Zeichenkodierung

Das Laden von textbasierten Inhalten hat Macromedia von Flash 5 nach Flash 6 geändert. Es basiert nun auf Unicode. Aus diesem Grund sollten Sie Dokumente für Flash 6 als Unicode (oder UTF-8) bereitstellen. Alternativ kann Flash 6 mit der Eigenschaft System.useCodepage=true auch dazu gezwungen werden, die Zeichenkodierung des Betriebssystems zu verwenden.

12.4.8 onDragOut 

Das Ereignis onDragOut wird immer dann ausgelöst, wenn auf den aktiven Bereich einer Instanz geklickt und dann der Mauszeiger mit gedrückter Maustaste aus dem aktiven Bereich herausgezogen wird (siehe Movieclip und Button in der Kurzreferenz).

Bemerkung:

Syntax:

movieClipInstanz.onDragOut();
buttonInstanz.onDragOut();

Beispiel:

meinMovieclip.onDragOut = function () {
   // Vergrößere Instanz
   this._xscale=this._xscale*1.1;
   this._yscale=this._yscale*1.1;
};

12.4.9 onDragOver 

Das Ereignis onDragOver wird ausgelöst, wenn auf den aktiven Bereich einer Instanz geklickt, der Mauszeiger mit gedrückter Maustaste aus dem aktiven Bereich herausgezogen und anschließen wieder hineingezogen wird (siehe Movieclip und Button).

Bemerkung:

Syntax:

movieClipInstanz.onDragOver();
buttonInstanz.onDragOver();

Beispiel:

meinMovieclip.trackAsMenu = true;

onDragOver.fla

meinMovieclip.onDragOver = function() {
   // Verkleinere Instanz
   this._xscale = this._xscale/1.1;
   this._yscale = this._yscale/1.1;
};

12.4.10 onEnterFrame 

Das Ereignis onEnterFrame wird immer dann ausgelöst, wenn ein Bildwechsel stattfindet. Diese Ereignismethode verwenden Sie zum Beispiel immer dann, wenn Anweisungen regelmäßig wiederholt werden müssen (siehe Movieclip).

Bemerkung:

Syntax:

movieClipInstanz.onEnterFrame();

Beispiel:

mcKuh.onEnterFrame = function() {

onEnterFrame.fla

   // Bewege Objekt von links nach recht
   this._x = (this._x+5);
   // Beschränke auf die Bühne (Modulo-Operation)
   this._x = this._x%550;
   // Bewege auf und ab
   this._y = 200-Math.abs(Math.sin(this._x/25))*50;
};

Hauptprogramm (main)

Einige Programmiersprachen benötigen eine Art »Hauptprogramm«. Bei dieser häufig als main bezeichneten Methode handelt es sich um den Kern der Anwendung. Häufig besteht diese Methode aus einer sich regelmäßig wiederholenden Schleife, die den gesamten Programmablauf steuert. Da Flash eine ereignisorientierte Sprache ist, gibt es diese Form eines »Hauptprogramms« nicht. Dennoch kann eine Hauptschleife (Mainloop), also eine sich wiederholende Programmsteuerung, erzeugt werden, indem zum Beispiel die Hauptzeitleiste mit einer onEnterFrame-Ereignismethode versehen wird. Gerade für Spiele ist das häufig nützlich:

_root.onEnterFrame = function() {
   // Überprüfe Kollisionen
   anweisungen;
   // Bewege Objekte
   anweisungen;
};

12.4.11 onID3 

Das Ereignis onID3 wird immer dann ausgelöst, wenn eine Sound-Instanz ID3-Informationen empfängt (siehe Sound, Seite 632).

Bemerkung:

Syntax:

soundInstanz.onID3();

12.4.12 onKeyDown 

Das Ereignis onKeyDown wird immer dann ausgelöst, wenn eine Taste gedrückt wird (siehe Movieclip, Seite 625). Um die gedrückte Taste zu ermitteln, verwenden Sie das Key-Objekt.

Bemerkung:

Achtung

movieClipInstanz.focusEnabled = true;
Selection.setFocus(movieClipInstanz);

Syntax:

movieClipInstanz.onKeyDown();
buttonInstanz.onKeyDown();

Beispiel:

mcMonster.focusEnabled = true;

onKeyDown.fla

mcMonster.onKeyDown = function() {
   this._x = 500;
};
mcMonster.onEnterFrame = function() {
   this._x = this._x/1.1;
   Selection.setFocus(mcMonster);
};

12.4.13 onKeyUp 

Das Ereignis onKeyDown wird immer dann ausgelöst, wenn eine Taste losgelassen wird (siehe Movieclip, Seite 625). Um die losgelassene Taste zu ermitteln, verwenden Sie das Key-Objekt.

Bemerkung:

Achtung

movieClipInstanz.focusEnabled = true;
Selection.setFocus(movieClipInstanz);

Syntax:

movieClipInstanz.onKeyUp();
buttonInstanz.onKeyUp();

Beispiel:

mcMonster.focusEnabled = true;

onKeyUp.fla

mcMonster.onKeyUp = function() {
   this._y = 400;
};
mcMonster.onEnterFrame = function() {
   this._y = this._y/1.1;
   Selection.setFocus(mcMonster);
};

12.4.14 onKillFocus 

Das Ereignis onKillFocus wird immer dann ausgelöst, wenn eine Instanz den Fokus verliert. Dies können Sie zum Beispiel für Formularüberprüfungen verwenden (siehe Button, Movieclip und Textfield).

Bemerkung:

Syntax:

movieClipInstanz.onKillFocus(neuerFokus);
buttonInstanz.onKillFocus(neuerFokus);
textfieldInstanz.onKillFocus(neuerFokus);

Parameter:

Beispiel:

meinTextfeld1.onKillFocus=function (neuerFokus) {

onKillFocus.fla

   trace("Sie haben den Fokus zu "
    + neuerFokus + " gewechselt!");
}

12.4.15 onLoad 

Das Ereignis onLoad wird immer dann ausgelöst, wenn ein Ladevorgang abgeschlossen ist (LoadVars, Sound, TextField.StyleSheet, XML) oder eine Instanz erzeugt wird (Movieclip). Dies verwenden Sie zum Beispiel für Initialisierungsanweisungen (siehe LoadVars, Sound, TextField.StyleSheet, XML und Movieclip in der Kurzreferenz).

Bemerkung:

Syntax:

movieClipInstanz.onLoad();
soundInstanz.onLoad();
xmlInstanz.onLoad(erfolgreich);
loadVarsInstanz.onLoad(erfolgreich);
textFieldStyleSheetInstanz.onLoad(erfolgreich);

Parameter:

Beispiel:

meinSound = new Sound();

onLoad.fla

meinSound.onLoad = function() {
   this.start();
};
meinSound.loadSound("meinSound.mp3");}

Ereignismethode onLoad geht nicht

Die Ereignismethode onLoad widersetzt sich in manchen Situationen den eigenen Vorstellungen und scheint nicht auf Ereignisse zu reagieren.

Dies passiert bei Movieclips z.B. immer dann, wenn eine Instanz keine Ereignisprozeduren besitzt. Aus diesem Grund ist es in diesem Fall von Vorteil, auf die onLoad-Methode zu verzichten und notwendige Initialisierungen direkt zuzuweisen (ohnehin kann eine Methode einer Instanz ja erst dann zugewiesen werden, wenn diese bereits existiert, und dann kann es ja auch kein Ereignis mehr über die Erzeugung geben): Anstelle von

mcMonster.onLoad = function() {

onLoad vermeiden.fla

   // Initialisiere Startposition
   this._x = 10;
   this._y = 10;
};

schreiben Sie

// Initialisiere Startposition
mcMonster._x = 10;
mcMonster._y = 10;

Bei Ereignisprozeduren (onClipEvent) gibt es dieses eigentümliche Verhalten glücklicherweise nicht.

Aber auch bei den anderen Objektarten kommt es gelegentlich zu einer Ignoranz gegenüber dieser Methode. Dies liegt meist daran, dass die Definition der onLoad-Methode nach dem Aufruf des Ladevorgangs platziert ist und deshalb in einigen wenigen Fällen beim Abschluss des Ladens noch gar nicht existiert. Definieren Sie darum immer zuerst alle Ereignismethoden, bevor Sie weitere Methoden aufrufen.

// falsch
meineInstanz.load(url);
meineInstanz.onLoad=function () {.};
// richtig
meineInstanz.onLoad=function () {.};
meineInstanz.load(url);

12.4.16 onMouseDown 

Das Ereignis onMouseDown wird immer dann ausgelöst, wenn der Anwender die Maustaste drückt (siehe Movieclip, Seite 625).

Bemerkung:

Syntax:

movieClipInstanz.onMouseDown();

Beispiel:

this.lineStyle(0, 0xFF0000, 100);

onMouseDown.fla

this.moveTo(this._xmouse, this._ymouse);

this.onMouseDown=function () {
   // Zeichne Linie bis zum Mauszeiger
   this.lineTo(this._xmouse, this._ymouse);
}

12.4.17 onMouseMove 

Das Ereignis onMouseMove wird immer dann ausgelöst, wenn der Anwender die Maus bewegt (siehe Movieclip, Seite 625).

Bemerkung:

Syntax:

movieClipInstanz.onMouseMove();

Beispiel:

this.lineStyle(0, 0xFF0000, 100);
this.moveTo(this._xmous