处理 AIR 中与 HTML 相关的事件

每个事件对象都有关联的事件类型。数据类型以字符串值的形式存储在 Event.type 属性中。知道事件对象的类型是非常有用的，这样您的代码就可以区分不同类型的对象。例如，下面的代码注册一个 fileReadHandler() 侦听器函数以响应 myFileStream 调度的 complete 事件：

myFileStream.addEventListener(Event.COMPLETE, fileReadHandler);

AIR Event 类定义许多类常量（如 COMPLETE 、 CLOSING 和 ID3 ），以表示运行时对象调度的事件的类型。这些常量列在 针对 HTML 开发人员的 Adobe AIR API 参考 的“Event 类”页面中。

事件常量提供了引用特定事件类型的简便方法。使用常量（而不是字符串值）可帮助您更快地识别拼写错误。如果您的代码中拼错了某个常量名，则 JavaScript 分析器将捕获到该错误。而如果您拼错了事件字符串，将会为永远都不会调度的一种事件注册事件处理函数。因此，在添加事件侦听器时，建议使用下面的代码：

myFileStream.addEventListener(Event.COMPLETE, htmlRenderHandler);

而不是使用：

myFileStream.addEventListener("complete", htmlRenderHandler);

代码可通过访问 cancelable 属性来检查是否可以阻止任何给定事件对象的默认行为。 cancelable 属性保存着一个布尔值，用于指示是否可以阻止默认行为。您可以使用 preventDefault() 方法阻止或取消与少量事件关联的默认行为。有关详细信息，请参阅 取消事件默认行为 。

Event 类有两个实用程序方法。 clone() 方法用于创建事件对象的副本。 toString() 方法用于生成事件对象属性的字符串表示形式以及它们的值。

与取消默认行为有关的两个方法是 preventDefault() 方法和 isDefaultPrevented() 方法。调用 preventDefault() 方法可取消与事件关联的默认行为。使用 isDefaultPrevented() 方法可检查是否已对事件对象调用 preventDefault() 。

preventDefault() 方法仅在可以取消事件的默认行为时才起作用。您可以通过查阅 API 文档，或通过检查事件对象的 cancelable 属性，来检查事件是否有可以取消的行为。

取消默认行为对事件对象通过事件流的进度没有影响。使用 Event 类的事件流方法可以从事件流中删除事件对象。

可以使用 removeEventListener() 方法删除不再需要的事件侦听器。建议删除将不再使用的所有侦听器。必需的参数包括 eventName 和 listener 参数，这些参数与 addEventListener() 方法的必需参数相同。

当 HTML 内容进行导航时，或者因包含 HTML 内容的窗口关闭而丢弃这些 HTML 内容时，不会自动删除引用已卸载的页面中对象的事件侦听器。当对象向已卸载的处理函数调度事件时，会显示下面的错误消息：“应用程序尝试引用不再处于已加载状态的 HTML 页面中的 JavaScript 对象。”(The application attempted to reference a JavaScript object in an HTML page that is no longer loaded.)

为避免出现此错误，请在 HTML 页面退出之前删除其中的 JavaScript 事件侦听器。如果发生页面导航（在 HTMLLoader 对象中），请在 window 对象的 unload 事件发生期间删除事件侦听器。

例如，下面的 JavaScript 代码删除 uncaughtScriptException 事件的事件侦听器：

window.onunload = cleanup; 
window.htmlLoader.addEventListener('uncaughtScriptException', uncaughtScriptException); 
function cleanup() 
{ 
    window.htmlLoader.removeEventListener('uncaughtScriptException', 
                            uncaughtScriptExceptionHandler); 
}

为避免在关闭包含 HTML 内容的窗口时发生错误，请调用 cleanup 函数以响应 NativeWindow 对象 ( window.nativeWindow ) 的 closing 事件。例如，下面的 JavaScript 代码删除 uncaughtScriptException 事件的事件侦听器：

window.nativeWindow.addEventListener(air.Event.CLOSING, cleanup); 
function cleanup() 
{ 
    window.htmlLoader.removeEventListener('uncaughtScriptException', 
                            uncaughtScriptExceptionHandler); 
}

为了防止发生此错误，您还可以在事件侦听器运行时将其删除（如果该事件只需要处理一次）。例如，下面的 JavaScript 代码通过调用 HTMLLoader 类的 createRootWindow() 方法创建一个 html 窗口，并为 complete 事件添加一个事件侦听器。在调用 complete 事件处理函数时，它会使用 removeEventListener() 函数删除它自己的事件侦听器：

var html = runtime.flash.html.HTMLLoader.createRootWindow(true); 
html.addEventListener('complete', htmlCompleteListener); 
function htmlCompleteListener() 
{ 
    html.removeEventListener(complete, arguments.callee) 
    // handler code.. 
} 
html.load(new runtime.flash.net.URLRequest("second.html"));

如果删除不需要的事件侦听器，则还会使系统垃圾回收器能回收与这些侦听器关联的任何内存空间。

hasEventListener() 方法用于检查某个对象是否存在事件侦听器。