Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Verarbeiten HTML-bezogener Ereignisse in AIR
Entfernen von Ereignisprozeduren
Adobe AIR 1.0 und höher
Mit der removeEventListener()-Methode können Sie einen Ereignis-Listener entfernen, den Sie nicht mehr
benötigen. Es empfiehlt sich, alle nicht mehr benötigten Listener zu entfernen. Erforderliche Parameter sind
eventName und listener, die identisch sind mit den erforderlichen Parametern für die addEventListener()-
Methode.
Entfernen von Ereignis-Listenern auf navigierenden HTML-Seiten
Adobe AIR 1.0 und höher
Wenn HTML-Inhalt Navigationsvorgänge ausführt oder wenn HTML-Inhalt verworfen wird, da das Fenster mit dem
Inhalt geschlossen wird, werden die Ereignis-Listener, die auf Objekte auf der entladenen Seite verweisen, nicht
automatisch entfernt. Wenn ein Objekt ein Ereignis für eine Prozedur auslöst, die bereits entladen wurde, wird die
folgende Fehlermeldung angezeigt: „The application attempted to reference a JavaScript object in an HTML page that
is no longer loaded.“ (Die Anwendung hat versucht, auf ein JavaScript-Objekt auf einer HTML-Seite zu verweisen, die
nicht mehr geladen ist.)
Um diesen Fehler zu vermeiden, entfernen Sie JavaScript-Ereignis-Listener auf einer HTML-Seite, bevor sie entladen
wird. Bei der Seitennavigation (in einem HTMLLoader-Objekt) entfernen Sie den Ereignis-Listener während des
unload-Ereignisses des window-Objekts.
Mit dem folgenden JavaScript-Code wird ein Ereignis-Listener für ein uncaughtScriptException-Ereignis entfernt:
window.onunload = cleanup;
window.htmlLoader.addEventListener('uncaughtScriptException', uncaughtScriptException);
function cleanup()
{
window.htmlLoader.removeEventListener('uncaughtScriptException',
uncaughtScriptExceptionHandler);
}
Damit der Fehler nicht beim Schließen von Fenstern mit HTML-Inhalt auftritt, rufen Sie eine Bereinigungsfunktion
als Reaktion auf das closing-Ereignis des NativeWindow-Objekts (window.nativeWindow) auf. Mit dem folgenden
JavaScript-Code wird ein Ereignis-Listener für ein uncaughtScriptException-Ereignis entfernt:
window.nativeWindow.addEventListener(air.Event.CLOSING, cleanup);
function cleanup()
{
window.htmlLoader.removeEventListener('uncaughtScriptException',
uncaughtScriptExceptionHandler);
}
Sie können diesen Fehler auch verhindern, indem Sie einen Ereignis-Listener entfernen, sobald er ausgeführt wird
(falls das Ereignis nur einmal verarbeitet werden muss). Mit dem folgenden JavaScript-Code wird zum Beispiel ein
Html-Fenster erstellt, indem die createRootWindow()-Methode der HTMLLoader-Klasse aufgerufen und ein
Ereignis-Listener für das complete-Ereignis aufgerufen wird. Wenn die complete-Ereignisprozedur aufgerufen wird,
entfernt sie ihren eigenen Ereignis-Listener mit der removeEventListener()-Funktion:
Letzte Aktualisierung 27.6.2012
1091