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

The interface that the shared instance of the BrowserManager implements. Applications listen for events, call methods, and access properties on the shared instance which is accessed with the BrowserManager.getInstance() method.

相關 API 元素

mx.managers.BrowserManager

公用屬性

	屬性		定義自
		base : String [唯讀] The portion of current URL before the '#' as it appears in the browser address bar.	IBrowserManager
		fragment : String [唯讀] The portion of current URL after the '#' as it appears in the browser address bar.	IBrowserManager
		title : String [唯讀] The title of the application as it should appear in the browser history.	IBrowserManager
		url : String [唯讀] The current URL as it appears in the browser address bar.	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 Initializes the BrowserManager.	IBrowserManager
		initForHistoryManager():void Initializes the BrowserManager.	IBrowserManager
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 會從 EventDispatcher 物件移除偵聽程式。	IEventDispatcher
		setFragment(value:String):void Changes the fragment of the URL after the '#' in the browser.	IBrowserManager
		setTitle(value:String):void Changes the text in the browser's title bar.	IBrowserManager
		willTrigger(type:String):Boolean 檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。	IEventDispatcher

事件

按一下以瞭解事件的詳細資訊

	摘要	定義自
browserURLChange	Dispatched when the URL is changed by the browser.	IBrowserManager
change	Dispatched when the URL is changed either by the user interacting with the browser, invoking an application in AIR, or by setting the property programmatically.	IBrowserManager
urlChange	Dispatched when the URL is changed by the application.	IBrowserManager

屬性詳細資訊

base

屬性

base:String [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The portion of current URL before the '#' as it appears in the browser address bar.

實作
public function get base():String

fragment

屬性

fragment:String [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The portion of current URL after the '#' as it appears in the browser address bar. Use the setURLFragment() method to change this value.

實作
public function get fragment():String

title

屬性

title:String [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The title of the application as it should appear in the browser history.

實作
public function get title():String

url

屬性

url:String [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The current URL as it appears in the browser address bar.

實作
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

Initializes the BrowserManager. The BrowserManager will get the initial URL. If it has a fragment, it will dispatch a BROWSER_URL_CHANGE event. This method sets the value of the ApplicationGlobals.application.historyManagementEnabled property to false because the HistoryManager generally interferes with your application's handling of URL fragments.

參數

	`value:String` (default = `null`) — The fragment to use if no fragment is in the initial URL.

	`title:String` (default = `null`) — The title to use if no fragment is in the initial URL.

initForHistoryManager

()

方法

public function initForHistoryManager():void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Initializes the BrowserManager. The HistoryManager calls this method to prepare the BrowserManager for further calls from the HistoryManager. You cannot use the HistoryManager and call the setFragment() method from the application. As a result, the init() method usually sets the value of the ApplicationGlobals.application.historyManagementEnabled property to false to disable the HistoryManager.

setFragment

()

方法

public function setFragment(value:String):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Changes the fragment of the URL after the '#' in the browser. An attempt will be made to track this URL in the browser's history.

If the title is set, the old title in the browser is replaced by the new title.

To store the URL, a JavaScript method named setBrowserURL() will be called. The application's HTML wrapper must have that method which must implement a mechanism for taking this value and registering it with the browser's history scheme and address bar.

When set, the APPLICATION_URL_CHANGE event is dispatched. If the event is cancelled, the setBrowserURL() method will not be called.

參數

value:String — The new fragment to use after the '#' in the URL.

setTitle

()

方法

public function setTitle(value:String):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Changes the text in the browser's title bar. This method does not affect the browser's history.

參數

value:String — The new title to use in the browser's title bar.

事件詳細資訊

browserURLChange

事件

事件物件類型: mx.events.BrowserChangeEvent
屬性 BrowserChangeEvent.type = mx.events.BrowserChangeEvent.BROWSER_URL_CHANGE

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Dispatched when the URL is changed by the browser.

The BrowserChangeEvent.BROWSER_URL_CHANGE constant defines the value of the type property of the event object for a browserURLChange event.

The properties of the event object have the following values:

Property	Value
`bubbles`	false
`cancelable`	false
`currentTarget`	The Object that defines the event listener that handles the event. For example, if you use `myButton.addEventListener()` to register an event listener, myButton is the value of the `currentTarget`.
`lastURL`	The previous value of the BrowserManager's `url` property.
`target`	The Object that dispatched the event; it is not always the Object listening for the event. Use the `currentTarget` property to always access the Object listening for the event.
`url`	The new value of the BrowserManager's `url` property.

change

事件

事件物件類型: flash.events.Event
屬性 Event.type = flash.events.Event.CHANGE

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Dispatched when the URL is changed either by the user interacting with the browser, invoking an application in AIR, or by setting the property programmatically.

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

Dispatched when the URL is changed by the application.

The BrowserChangeEvent.URL_CHANGE constant defines the value of the type property of the event object for a urlChange event.

The properties of the event object have the following values:

Property	Value
`bubbles`	false
`cancelable`	false
`currentTarget`	The Object that defines the event listener that handles the event. For example, if you use `myButton.addEventListener()` to register an event listener, myButton is the value of the `currentTarget`.
`lastURL`	The previous value of the BrowserManager's `url` property.
`target`	The Object that dispatched the event; it is not always the Object listening for the event. Use the `currentTarget` property to always access the Object listening for the event.
`url`	The new value of the BrowserManager's `url` property.

法律聲明 | 線上隱私權政策

IBrowserManager - AS3 Flex

類別 x

base

fragment

title

url

init

initForHistoryManager

setFragment

setTitle

browserURLChange

change

urlChange