public interface IBrowserManager extends flash.events.IEventDispatcher
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
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.
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.
Dispatched when the URL is changed by the application.
IBrowserManager
Property Detail
base
property
base:String [read-only]
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
Flash Player 9, AIR 1.1
The portion of current URL before the '#' as it appears
in the browser address bar.
Implementation public function get base():String
fragment
property
fragment:String [read-only]
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
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.
Implementation public function get fragment():String
title
property
title:String [read-only]
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
Flash Player 9, AIR 1.1
The title of the application as it should appear in the
browser history.
Implementation public function get title():String
url
property
url:String [read-only]
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
Flash Player 9, AIR 1.1
The current URL as it appears in the browser address bar.
Implementation public function get url():String
Method Detail
init
()
method
public function init(value:String = null, title:String = null):void
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
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.
Parameters
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
()
method
public function initForHistoryManager():void
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
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
()
method
public function setFragment(value:String):void
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
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.
Parameters
value:String — The new fragment to use after the '#' in the URL.
setTitle
()
method
public function setTitle(value:String):void
Language Version :
ActionScript 3.0
Product Version :
Flex 3
Runtime Versions :
Flash Player 9, AIR 1.1
Changes the text in the browser's title bar.
This method does not affect the browser's history.
Parameters
value:String — The new title to use in the browser's title bar.
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.
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.
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.