IBrowserManager - Adobe ActionScript® 3 (AS3 Flex) API-Referenz

Paket	mx.managers
Schnittstelle	public interface IBrowserManager extends IEventDispatcher

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die Schnittstelle, die von der gemeinsam genutzten Instanz des BrowserManagers implementiert wird. Anwendungen warten auf der gemeinsam genutzten Instanz auf Ereignisse, rufen Methoden auf und greifen auf Eigenschaften zu. Der Zugriff auf die gemeinsam genutzte Instanz erfolgt über die BrowserManager.getInstance()-Methode.

Verwandte API-Elemente

mx.managers.BrowserManager

Öffentliche Eigenschaften

	Eigenschaft		Definiert von
		base : String [schreibgeschützt] Der Teil der aktuellen URL, der sich vor dem „#“ in der Adresszeile des Browsers befindet.	IBrowserManager
		fragment : String [schreibgeschützt] Der Teil der aktuellen URL, der sich nach dem „#“ in der Adresszeile des Browsers befindet.	IBrowserManager
		title : String [schreibgeschützt] Der Titel der Anwendung, der im Browserverlauf angezeigt werden soll.	IBrowserManager
		url : String [schreibgeschützt] Die aktuelle URL, die in der Adresszeile des Browsers angezeigt wird.	IBrowserManager

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.	IEventDispatcher
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	IEventDispatcher
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	IEventDispatcher
		init(value:String = null, title:String = null):void Initialisiert den BrowserManager.	IBrowserManager
		initForHistoryManager():void Initialisiert den BrowserManager.	IBrowserManager
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	IEventDispatcher
		setFragment(value:String):void Ändert das Fragment der URL, das nach dem „#“ im Browser angezeigt wird.	IBrowserManager
		setTitle(value:String):void Ändert den Text in der Titelleiste des Browsers.	IBrowserManager
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	IEventDispatcher

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

	Übersicht	Definiert von
browserURLChange	Wird ausgelöst, wenn die URL durch den Browser geändert wird.	IBrowserManager
change	Wird bei Änderung der URL ausgelöst, indem entweder der Benutzer mit dem Browser interagiert und eine Anwendung in AIR aufruft oder durch programmgesteuertes Einstellen der Eigenschaft.	IBrowserManager
urlChange	Wird ausgelöst, wenn die URL durch die Anwendung geändert wird.	IBrowserManager

Eigenschaftendetails

base	Eigenschaft

base:String [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Der Teil der aktuellen URL, der sich vor dem „#“ in der Adresszeile des Browsers befindet.

Implementierung
public function get base():String

fragment

Eigenschaft

fragment:String [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Der Teil der aktuellen URL, der sich nach dem „#“ in der Adresszeile des Browsers befindet. Verwenden Sie die setURLFragment()-Methode, um diesen Wert zu ändern.

Implementierung
public function get fragment():String

title

Eigenschaft

title:String [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Der Titel der Anwendung, der im Browserverlauf angezeigt werden soll.

Implementierung
public function get title():String

url

Eigenschaft

url:String [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die aktuelle URL, die in der Adresszeile des Browsers angezeigt wird.

Implementierung
public function get url():String

Methodendetails

init

()

Methode

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

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Initialisiert den BrowserManager. Der BrowserManager ruft die anfängliche URL ab. Ist ein Fragment vorhanden, wird ein BROWSER_URL_CHANGE-Ereignis ausgelöst. Diese Methode setzt den Wert der ApplicationGlobals.application.historyManagementEnabled-Eigenschaft auf false, da der HistoryManager die Verarbeitung der URL-Fragmente in Ihrer Anwendung beeinträchtigt.

Parameter

	`value:String` (default = `null`) — Das zu verwendende Fragment, wenn die anfängliche URL kein Fragment enthält.

	`title:String` (default = `null`) — Der zu verwendende Titel, wenn die anfängliche URL kein Fragment enthält.

initForHistoryManager

()

Methode

public function initForHistoryManager():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Initialisiert den BrowserManager. Der HistoryManager ruft diese Methode auf, um den BrowserManager auf weitere Aufrufe vom HistoryManager vorzubereiten. Sie können den HistoryManager nicht verwenden und die setFragment()-Methode von der Anwendung aufrufen. Daher setzt die init()-Methode normalerweise den Wert der ApplicationGlobals.application.historyManagementEnabled-Eigenschaft auf false, um den HistoryManager zu deaktivieren.

setFragment

()

Methode

public function setFragment(value:String):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Ändert das Fragment der URL, das nach dem „#“ im Browser angezeigt wird. Es wird versucht, diese URL im Verlauf des Browsers zu verfolgen.

Wenn der Titel festgelegt ist, wird der alte Titel im Browser durch den neuen Titel ersetzt.

Um die URL zu speichern, wird eine JavaScript-Methode mit dem Namen setBrowserURL() aufgerufen. Der HTML-Wrapper der Anwendung muss diese Methode aufweisen. Sie muss einen Mechanismus implementieren, der diesen Wert annimmt und beim Verlaufsschema des Browsers und der Adresszeile registriert.

Wenn festgelegt, wird das APPLICATION_URL_CHANGE-Ereignis ausgelöst. Wird das Ereignis abgebrochen, dann wird die setBrowserURL()-Methode nicht aufgerufen.

Parameter

value:String — Das nach dem „#“ in der URL zu verwendende neue Fragment.

setTitle

()

Methode

public function setTitle(value:String):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Ändert den Text in der Titelleiste des Browsers. Diese Methode wirkt sich nicht auf den Verlauf des Browsers aus.

Parameter

value:String — Der neue Titel, der in der Titelleiste des Browsers verwendet werden soll.

Ereignisdetails

browserURLChange

Ereignis

Ereignisobjekttyp: mx.events.BrowserChangeEvent
Eigenschaft BrowserChangeEvent.type = mx.events.BrowserChangeEvent.BROWSER_URL_CHANGE

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Wird ausgelöst, wenn die URL durch den Browser geändert wird.

Die BrowserChangeEvent.BROWSER_URL_CHANGE-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein browserURLChange-Ereignis.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

Eigenschaft	Wert
`bubbles`	false
`cancelable`	false
`currentTarget`	Das Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise `myButton.addEventListener()` zur Registrierung eines Ereignis-Listeners verwenden, weist `currentTarget` den Wert „myButton“ auf.
`lastURL`	Der vorherige Wert der Eigenschaft `url` des BrowserManagers.
`target`	Das Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die `currentTarget`-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.
`url`	Der neue Wert der Eigenschaft `url` des BrowserManagers.

change

Ereignis

Ereignisobjekttyp: flash.events.Event
Eigenschaft Event.type = flash.events.Event.CHANGE

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Wird bei Änderung der URL ausgelöst, indem entweder der Benutzer mit dem Browser interagiert und eine Anwendung in AIR aufruft oder durch programmgesteuertes Einstellen der Eigenschaft.

Die Event.CHANGE-Konstante definiert den Wert der type-Eigenschaft eines change-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Eigenschaft	Wert
`bubbles`	`true`
`cancelable`	`false`. Es gibt kein Standardverhalten, das abgebrochen werden kann.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`target`	Das Objekt, dessen Wert geändert wurde. Das unter `target` angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft `currentTarget` können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.

urlChange

Ereignis

Ereignisobjekttyp: mx.events.BrowserChangeEvent
Eigenschaft BrowserChangeEvent.type = mx.events.BrowserChangeEvent.URL_CHANGE

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Wird ausgelöst, wenn die URL durch die Anwendung geändert wird.

Die BrowserChangeEvent.URL_CHANGE-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein urlChange-Ereignis.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

Eigenschaft	Wert
`bubbles`	false
`cancelable`	false
`currentTarget`	Das Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise `myButton.addEventListener()` zur Registrierung eines Ereignis-Listeners verwenden, weist `currentTarget` den Wert „myButton“ auf.
`lastURL`	Der vorherige Wert der Eigenschaft `url` des BrowserManagers.
`target`	Das Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die `currentTarget`-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.
`url`	Der neue Wert der Eigenschaft `url` des BrowserManagers.

Rechtliche Hinweise | Onlinedatenschutzerklärung

IBrowserManager - AS3 Flex

Klassen x

base

fragment

title

url

init

initForHistoryManager

setFragment

setTitle

browserURLChange

change

urlChange