IBrowserManager - Adobe ActionScript® 3 (AS3 Flex) API 参考

包	mx.managers
接口	public interface IBrowserManager extends IEventDispatcher

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

由 BrowserManager 的共享实例实现的接口。应用程序可在使用 BrowserManager.getInstance() 方法访问的共享实例上侦听事件、调用方法以及访问属性。

相关 API 元素

mx.managers.BrowserManager

公共属性

	属性		由以下参数定义
		base : String [只读] 当前 URL 显示在浏览器地址栏中时，“#”之前的部分。	IBrowserManager
		fragment : String [只读] 当前 URL 显示在浏览器地址栏中时，“#”之后的部分。	IBrowserManager
		title : String [只读] 应用程序在浏览器历史记录中应显示的标题。	IBrowserManager
		url : String [只读] 当前显示在浏览器地址栏中的 URL。	IBrowserManager

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	IEventDispatcher
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	IEventDispatcher
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	IEventDispatcher
		init(value:String = null, title:String = null):void 初始化 BrowserManager。	IBrowserManager
		initForHistoryManager():void 初始化 BrowserManager。	IBrowserManager
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	IEventDispatcher
		setFragment(value:String):void 更改浏览器中“#”后面的 URL 片段。	IBrowserManager
		setTitle(value:String):void 更改浏览器标题栏中的文本。	IBrowserManager
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	IEventDispatcher

事件

单击此处了解有关事件的更多信息

	摘要	由以下参数定义
browserURLChange	当浏览器更改 URL 时调度。	IBrowserManager
change	当通过用户与浏览器交互、调用 AIR 中的应用程序或以编程方式设置此属性来更改 URL 时调度。	IBrowserManager
urlChange	当应用程序更改 URL 时调度。	IBrowserManager

属性详细信息

base

属性

base:String [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当前 URL 显示在浏览器地址栏中时，“#”之前的部分。

实现
public function get base():String

fragment

属性

fragment:String [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当前 URL 显示在浏览器地址栏中时，“#”之后的部分。使用 setURLFragment() 方法可更改此值。

实现
public function get fragment():String

title

属性

title:String [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

应用程序在浏览器历史记录中应显示的标题。

实现
public function get title():String

url

属性

url:String [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当前显示在浏览器地址栏中的 URL。

实现
public function get url():String

方法详细信息

init

()

方法

public function init(value:String = null, title:String = null):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

初始化 BrowserManager。BrowserManager 将获取初始 URL。如果它包含片段，则调度 BROWSER_URL_CHANGE 事件。此方法将 ApplicationGlobals.application.historyManagementEnabled 属性的值设置为 false，这是因为 HistoryManager 通常会干扰应用程序的 URL 段处理。

参数

	`value:String` (default = `null`) — 当初始 URL 中没有片段时使用的片段。

	`title:String` (default = `null`) — 当初始 URL 中没有片段时使用的标题。

initForHistoryManager

()

方法

public function initForHistoryManager():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

初始化 BrowserManager。HistoryManager 调用此方法来准备 BrowserManager，供 HistoryManager 以后调用。无法从应用程序中使用 HistoryManager 调用 setFragment() 方法。因此，init() 方法通常将 ApplicationGlobals.application.historyManagementEnabled 属性的值设置为 false，以禁用 HistoryManager。

setFragment

()

方法

public function setFragment(value:String):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

更改浏览器中“#”后面的 URL 片段。系统将尝试在浏览器历史记录中跟踪此 URL。

如果设置了标题，则浏览器中的旧标题将被新标题取代。

若要存储 URL，则需调用称为 setBrowserURL() 的 JavaScript 方法。应用程序的 HTML 包装中必须包含该方法，该方法必须实现一种机制来采用此值并向浏览器的历史记录架构和地址栏注册此值。

设置完成后，调度 APPLICATION_URL_CHANGE 事件。如果取消此事件，则不会调用 setBrowserURL() 方法。

参数

value:String — URL 中“#”之后要使用的新片段。

setTitle

()

方法

public function setTitle(value:String):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

更改浏览器标题栏中的文本。此方法不会影响浏览器的历史记录。

参数

value:String — 浏览器的标题栏中要使用的新标题。

事件详细信息

browserURLChange

事件

事件对象类型: mx.events.BrowserChangeEvent
属性 BrowserChangeEvent.type = mx.events.BrowserChangeEvent.BROWSER_URL_CHANGE

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当浏览器更改 URL 时调度。

BrowserChangeEvent.BROWSER_URL_CHANGE 常量可为 browserURLChange 事件定义事件对象的 type 属性值。

事件对象的属性有下列值：

属性	值
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`lastURL`	BrowserManager 的 `url` 属性先前的值。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`url`	BrowserManager 的 `url` 属性的新值。

change

事件

事件对象类型: flash.events.Event
属性 Event.type = flash.events.Event.CHANGE

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当通过用户与浏览器交互、调用 AIR 中的应用程序或以编程方式设置此属性来更改 URL 时调度。

Event.CHANGE 常量定义 change 事件对象的 type 属性值。

此事件具有以下属性：

属性	值
`bubbles`	`true`
`cancelable`	`false`；没有要取消的默认行为。
`currentTarget`	当前正在使用某个事件侦听器处理 Event 对象的对象。
`target`	已修改其值的对象。`target` 不一定是显示列表中注册此事件侦听器的对象。请使用 `currentTarget` 属性来访问显示列表中当前正在处理此事件的对象。

urlChange

事件

事件对象类型: mx.events.BrowserChangeEvent
属性 BrowserChangeEvent.type = mx.events.BrowserChangeEvent.URL_CHANGE

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当应用程序更改 URL 时调度。

BrowserChangeEvent.URL_CHANGE 常量可为 urlChange 事件定义事件对象的 type 属性值。

事件对象的属性有下列值：

属性	值
`bubbles`	false
`cancelable`	false
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`lastURL`	BrowserManager 的 `url` 属性先前的值。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`url`	BrowserManager 的 `url` 属性的新值。

法律声明 | 在线隐私策略

IBrowserManager - AS3 Flex

类 x

base

fragment

title

url

init

initForHistoryManager

setFragment

setTitle

browserURLChange

change

urlChange