BrowserInvokeEvent

包	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 事件。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		arguments : Array [只读] 要传递给应用程序的参数（字符串）数组。	BrowserInvokeEvent
		bubbles : Boolean [只读] 表示事件是否为冒泡事件。	Event
		cancelable : Boolean [只读] 表示是否可以阻止与事件相关联的行为。	Event
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		currentTarget : Object [只读] 当前正在使用某个事件侦听器处理 Event 对象的对象。	Event
		eventPhase : uint [只读] 事件流中的当前阶段。	Event
		isHTTPS : Boolean [只读] 浏览器中的内容是否使用 HTTPS URL 架构，如果是，则为 true，否则为 false。	BrowserInvokeEvent
		isUserEvent : Boolean [只读] 浏览器调用是否生成用户事件（如鼠标单击）。	BrowserInvokeEvent
		sandboxType : String [只读] 浏览器中的内容的沙箱类型。	BrowserInvokeEvent
		securityDomain : String [只读] 浏览器中的内容的安全域，如“www.adobe.com”或“www.example.org”。	BrowserInvokeEvent
		target : Object [只读] 事件目标。	Event
		type : String [只读] 事件的类型。	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
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回一个字符串，其中包含 Event 对象的所有属性。	Event
		valueOf():Object 返回指定对象的原始值。	Object

公共常量

隐藏继承的公共常量

显示继承的公共常量

	常量		由以下参数定义
		BROWSER_INVOKE : String = "browserInvoke" [静态] BrowserInvokeEvent.BROWSER_INVOKE 常量定义 BrowserInvokeEvent 对象的 type 属性值。	BrowserInvokeEvent

属性详细信息

arguments

属性

arguments:Array [只读]

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0

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

实现
public function get arguments():Array

isHTTPS

属性

isHTTPS:Boolean [只读]

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0

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

实现
public function get isHTTPS():Boolean

isUserEvent

属性

isUserEvent:Boolean [只读]

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0

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

实现
public function get isUserEvent():Boolean

sandboxType

属性

sandboxType:String [只读]

语言版本:

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

securityDomain

属性

securityDomain:String [只读]

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0

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

实现
public function get securityDomain():String

构造函数详细信息

()

构造函数

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.BROWSER_INVOKE 常量定义 BrowserInvokeEvent 对象的 type 属性值。

BrowserInvokeEvent 对象具有以下属性：

属性	值
`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`	始终是 NativeApplication 对象。

BrowserInvokeEvent - AS3

类 x

arguments

isHTTPS

isUserEvent

sandboxType

securityDomain