flash.events.BrowserInvokeEvent (Flex 3.2)

（仅限 AIR）

包	flash.events
类	public class BrowserInvokeEvent
继承	BrowserInvokeEvent Event Object

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0

当由于浏览器中的 SWF 文件而使用浏览器调用功能调用 AIR 应用程序时，该应用程序的 NativeApplication 对象将调度 browserInvoke 事件。当用户在浏览器中实例化无缝安装功能并且浏览器中的 SWF 文件将数组传递给 air.swf 文件的 launchApplication() 方法的 arguments 参数时，NativeApplication 对象还将调度 browserInvoke 事件。（有关详细信息，请参阅 AIR 开发人员指南中的“Distributing, installing and running AIR applications”（分发、安装和运行 AIR 应用程序）。）

只有当应用程序在应用程序描述符文件中指定如下内容时才允许浏览器调用：

<allowBrowserInvocation>true</allowBrowserInvocation>

如果应用程序没有运行，则在从浏览器中启动时，NativeApplication 对象将调度 InvokeEvent 事件和 browserInvoke 事件。否则，如果应用程序已经在运行，则在从浏览器启动时，NativeApplication 对象将仅调度 browserInvoke 事件。

如果由于从浏览器无缝安装（用户选择在安装时启动）而启动应用程序，则只有在传递参数（通过浏览器中的 SWF 文件将数组传递给 air.swf 文件的 installApplication() 方法的 arguments 参数）时，NativeApplication 对象才调度 BrowserInvoke 事件。有关详细信息，请参阅 AIR 开发人员指南中的“Distributing, installing, and running AIR applications”（分发、安装和运行 AIR 应用程序）。

和 invokeEvent 事件一样，browserInvokeEvent 事件由 NativeApplication 对象 (NativeApplication.nativeApplication) 调度。若要接收 browserInvoke 事件，请调用 NativeApplication 对象的 addEventListener() 方法。当某个事件侦听器针对 browserInvoke 事件进行注册时，它还将接收在注册前发生的所有 browserInvoke 事件。在对 addEventListener() 的调用返回后调度这些事件，但并不一定在注册后可能接收到的其他 browserInvoke 事件之前。这样，您可以处理在初始化代码执行之前（如从浏览器首次调用应用程序时）已发生的 browserInvoke 事件。请记住，如果在执行后期（在应用程序初始化之后）添加一个事件侦听器，它仍然会接收到自应用程序启动时起发生的所有 browserInvoke 事件。

另请参见

flash.events.InvokeEvent
flash.desktop.NativeApplication

	属性	定义方
		arguments : Array [只读 (read-only)] 要传递给应用程序的参数（字符串）数组。	BrowserInvokeEvent
		bubbles : Boolean [只读 (read-only)] 指示事件是否为冒泡事件。	Event
		cancelable : Boolean [只读 (read-only)] 指示是否可以阻止与事件相关联的行为。	Event
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		currentTarget : Object [只读 (read-only)] 当前正在使用某个事件侦听器处理 Event 对象的对象。	Event
		eventPhase : uint [只读 (read-only)] 事件流中的当前阶段。	Event
		isHTTPS : Boolean [只读 (read-only)] 浏览器中的内容是否使用 HTTPS URL 架构，如果是，则为 true，否则为 false。	BrowserInvokeEvent
		isUserEvent : Boolean [只读 (read-only)] 浏览器调用是否生成用户事件（如鼠标单击）。	BrowserInvokeEvent
		prototype : Object [静态] 对类或函数对象的原型对象的引用。	Object
		sandboxType : String [只读 (read-only)] 浏览器中的内容的沙箱类型。	BrowserInvokeEvent
		securityDomain : String [只读 (read-only)] 浏览器中的内容的安全域，如“www.adobe.com”或“www.example.org”。	BrowserInvokeEvent
		target : Object [只读 (read-only)] 事件目标。	Event
		type : String [只读 (read-only)] 事件的类型。	Event

	方法	定义方
		BrowserInvokeEvent(type:String, bubbles:Boolean, cancelable:Boolean, arguments:Array, sandboxType:String, securityDomain:String, isHTTPS:Boolean, isUserEvent:Boolean) BrowserInvokeEvent 类的构造函数。	BrowserInvokeEvent
		clone():Event 创建此事件的新副本。	BrowserInvokeEvent
		formatToString(className:String, ... arguments):String 用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。	Event
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		isDefaultPrevented():Boolean 检查是否已对事件调用 preventDefault() 方法。	Event
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		preventDefault():void 如果可以取消事件的默认行为，则取消该行为。	Event
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		stopImmediatePropagation():void 防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。	Event
		stopPropagation():void 防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。	Event
		toString():String 返回一个字符串，其中包含 Event 对象的所有属性。	Event
		valueOf():Object 返回指定对象的原始值。	Object

公共常量

隐藏继承的公共常量

显示继承的公共常量

	常量		定义方
		ACTIVATE : String = "activate" [静态] ACTIVATE 常量定义 activate 事件对象的 type 属性的值。	Event
		ADDED : String = "added" [静态] Event.ADDED 常量定义 added 事件对象的 type 属性值。	Event
		ADDED_TO_STAGE : String = "addedToStage" [静态] Event.ADDED_TO_STAGE 常量定义 addedToStage 事件对象的 type 属性值。	Event
		BROWSER_INVOKE : String = "browserInvoke" [静态] BrowserInvokeEvent.INVOKE 常量定义 BrowserInvokeEvent 对象的 type 属性值。	BrowserInvokeEvent
		CANCEL : String = "cancel" [静态] Event.CANCEL 常量定义 cancel 事件对象的 type 属性的值。	Event
		CHANGE : String = "change" [静态] Event.CHANGE 常量定义 change 事件对象的 type 属性值。	Event
		CLEAR : String = "clear" [静态] Event.CLEAR 常量定义 clear 事件对象的 type 属性的值。	Event
		CLOSE : String = "close" [静态] Event.CLOSE 常量定义 close 事件对象的 type 属性的值。	Event
		CLOSING : String = "closing" [静态] Event.CLOSING 常量定义 closing 事件对象的 type 属性值。	Event
		COMPLETE : String = "complete" [静态] Event.COMPLETE 常量定义 complete 事件对象的 type 属性值。	Event
		CONNECT : String = "connect" [静态] Event.CONNECT 常量定义 connect 事件对象的 type 属性值。	Event
		COPY : String = "copy" [静态] 定义 copy 事件对象的 type 属性值。	Event
		CUT : String = "cut" [静态] 定义 cut 事件对象的 type 属性值。	Event
		DEACTIVATE : String = "deactivate" [静态] Event.DEACTIVATE 常量定义 deactivate 事件对象的 type 属性值。	Event
		DISPLAYING : String = "displaying" [静态] Event.DISPLAYING 常量定义 displaying 事件对象的 type 属性值。	Event
		ENTER_FRAME : String = "enterFrame" [静态] Event.ENTER_FRAME 常量定义 enterFrame 事件对象的 type 属性值。	Event
		EXIT_FRAME : String = "exitFrame" [静态] Event.EXIT_FRAME 常量定义 exitFrame 事件对象的 type 属性的值。	Event
		EXITING : String = "exiting" [静态] Event.EXITING 常量定义 exiting 事件对象的 type 属性值。	Event
		FRAME_CONSTRUCTED : String = "frameConstructed" [静态] Event.FRAME_CONSTRUCTED 常量定义 frameConstructed 事件对象的 type 属性的值。	Event
		FULLSCREEN : String = "fullScreen" [静态] Event.FULL_SCREEN 常量定义 fullScreen 事件对象的 type 属性值。	Event
		HTML_BOUNDS_CHANGE : String = "htmlBoundsChange" [静态] Event.HTML_BOUNDS_CHANGE 常量定义 htmlBoundsChange 事件对象的 type 属性值。	Event
		HTML_DOM_INITIALIZE : String = "htmlDOMInitialize" [静态] Event.HTML_DOM_INITIALIZE 常量定义 htmlDOMInitialize 事件对象的 type 属性值。	Event
		HTML_RENDER : String = "htmlRender" [静态] Event.HTML_RENDER 常量定义 htmlRender 事件对象的 type 属性值。	Event
		ID3 : String = "id3" [静态] Event.ID3 常量定义 id3 事件对象的 type 属性值。	Event
		INIT : String = "init" [静态] Event.INIT 常量定义 init 事件对象的 type 属性值。	Event
		LOCATION_CHANGE : String = "locationChange" [静态] Event.LOCATION_CHANGE 常量定义 locationChange 事件对象的 type 属性值。	Event
		MOUSE_LEAVE : String = "mouseLeave" [静态] Event.MOUSE_LEAVE 常量定义 mouseLeave 事件对象的 type 属性值。	Event
		NETWORK_CHANGE : String = "networkChange" [静态] Event.NETWORK_CHANGE 常量定义 networkChange 事件对象的 type 属性值。	Event
		OPEN : String = "open" [静态] Event.OPEN 常量用于定义 open 事件对象的 type 属性值。	Event
		PASTE : String = "paste" [静态] Event.PASTE 常量定义 paste 事件对象的 type 属性的值。	Event
		REMOVED : String = "removed" [静态] Event.REMOVED 常量定义 removed 事件对象的 type 属性值。	Event
		REMOVED_FROM_STAGE : String = "removedFromStage" [静态] Event.REMOVED_FROM_STAGE 常量定义 removedFromStage 事件对象的 type 属性值。	Event
		RENDER : String = "render" [静态] Event.RENDER 常量定义 render 事件对象的 type 属性的值。	Event
		RESIZE : String = "resize" [静态] Event.RESIZE 常量定义 resize 事件对象的 type 属性的值。	Event
		SCROLL : String = "scroll" [静态] Event.SCROLL 常量定义 scroll 事件对象的 type 属性值。	Event
		SELECT : String = "select" [静态] Event.SELECT 常量定义 select 事件对象的 type 属性的值。	Event
		SELECT_ALL : String = "selectAll" [静态] Event.SELECT_ALL 常量定义 selectAll 事件对象的 type 属性的值。	Event
		SOUND_COMPLETE : String = "soundComplete" [静态] Event.SOUND_COMPLETE 常量定义 soundComplete 事件对象的 type 属性值。	Event
		TAB_CHILDREN_CHANGE : String = "tabChildrenChange" [静态] Event.TAB_CHILDREN_CHANGE 常量定义 tabChildrenChange 事件对象的 type 属性值。	Event
		TAB_ENABLED_CHANGE : String = "tabEnabledChange" [静态] Event.TAB_ENABLED_CHANGE 常量定义 tabEnabledChange 事件对象的 type 属性值。	Event
		TAB_INDEX_CHANGE : String = "tabIndexChange" [静态] Event.TAB_INDEX_CHANGE 常量定义 tabIndexChange 事件对象的 type 属性值。	Event
		UNLOAD : String = "unload" [静态] Event.UNLOAD 常量定义 unload 事件对象的 type 属性值。	Event
		USER_IDLE : String = "userIdle" [静态] Event.USER_IDLE 常量定义 userIdle 事件对象的 type 属性值。	Event
		USER_PRESENT : String = "userPresent" [静态] Event.USER_PRESENT 常量定义 userPresent 事件对象的 type 属性值。	Event

属性详细信息

arguments

属性

arguments:Array [只读 (read-only)]

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0

要传递给应用程序的参数（字符串）数组。

实现
public function get arguments():Array

isHTTPS

属性

isHTTPS:Boolean [只读 (read-only)]

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0

浏览器中的内容是否使用 HTTPS URL 架构，如果是，则为 true，否则为 false。

实现
public function get isHTTPS():Boolean

isUserEvent

属性

isUserEvent:Boolean [只读 (read-only)]

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0

浏览器调用是否生成用户事件（如鼠标单击）。在 AIR 1.0 中，它始终设置为 true；AIR 需要用户事件以启动对浏览器调用功能的调用。

实现
public function get isUserEvent():Boolean

sandboxType

属性

sandboxType:String [只读 (read-only)]

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0

浏览器中的内容的沙箱类型。它可以设置为以下值之一：

Security.APPLICATION — 内容位于应用程序安全沙箱中。
Security.LOCAL_TRUSTED -- 内容位于受信任的本地安全沙箱中。
Security.LOCAL_WITH_FILE — 内容位于只能与本地文件系统内容交互的安全沙箱中。
Security.LOCAL_WITH_NETWORK — 内容位于只能与远程内容交互的安全沙箱中。
Security.REMOTE — 内容位于远程（网络）域中

实现
public function get sandboxType():String

另请参见

flash.system.Security.sandboxType

securityDomain

属性

securityDomain:String [只读 (read-only)]

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0

浏览器中的内容的安全域，如“www.adobe.com”或“www.example.org”。仅对于远程安全沙箱中的内容（来自网络域的内容）设置此属性，而不对位于本地或应用程序安全沙箱中的内容设置此属性。

实现
public function get securityDomain():String

构造函数详细信息

BrowserInvokeEvent

()

构造函数

public function BrowserInvokeEvent(type:String, bubbles:Boolean, cancelable:Boolean, arguments:Array, sandboxType:String, securityDomain:String, isHTTPS:Boolean, isUserEvent:Boolean)

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0

BrowserInvokeEvent 类的构造函数。通常，开发人员不直接调用 BrowserInvokeEvent() 构造函数。只有运行时才应创建 BrowserInvokeEvent 对象。

参数

	`type:String` — 事件的类型，可以作为 `Event.type` 访问。

	`bubbles:Boolean` — 对于 BrowserInvokeEvent 对象设置为 `false`。

	`cancelable:Boolean` — 对于 BrowserInvokeEvent 对象设置为 `false`。

	`arguments:Array` — 要传递给应用程序的参数（字符串）数组。

	`sandboxType:String` — 浏览器中的内容的沙箱类型。

	`securityDomain:String` — 浏览器中的内容的安全域。

	`isHTTPS:Boolean` — 浏览器中的内容是否使用 HTTPS URL 架构。

	`isUserEvent:Boolean` — 浏览器调用是否是用户事件的结果。

方法详细信息

clone

()

方法

override public function clone():Event

运行时版本:

AIR 1.0

创建此事件的新副本。

Event — 事件的副本。

常量详细信息

BROWSER_INVOKE

常量

public static const BROWSER_INVOKE:String = "browserInvoke"

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0

常量定义 BrowserInvokeEvent 对象的 type 属性值。

BrowserInvokeEvent 对象具有以下属性：

属性	Values
`arguments`	在此调用过程中传递的字符串参数的数组。
`sandBoxType`	一个字符串，表示浏览器中的内容的沙箱类型（`Security.APPLICATION`、`Security.LOCAL_TRUSTED`、`Security.LOCAL_WITH_FILE`、`Security.LOCAL_LOCAL_WITH_NETWORK` 或 `Security.REMOTE`）。
`securityDomain`	一个字符串，表示浏览器中的内容的安全域（如`“www.example.com”`）。
`isHTTPS`	浏览器内容是否使用 HTTPS URL 架构，如果是，则为 `true`，否则为 `false`
`isUserEvent`	浏览器调用是否因用户事件而导致（在 AIR 1.0 中始终为 `true`）。
`bubbles`	否。
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	指示当前正在使用事件侦听器处理此 InvokeEvent 对象的对象。
`target`	始终为对象。

另请参见

flash.desktop.NativeApplication

Adobe® Flex™ 3.2 语言参考		全部包 \| 全部类 \| 语言元素 \| 索引 \| 附录 \| 约定 \| 框架无框架
BrowserInvokeEvent	属性 \| 方法 \| 事件 \| 样式 \| 效果 \| 常量 \| 示例