IBrowserManager - Guide de référence de l’API Adobe ActionScript® 3 (AS3 Flex)

Package	mx.managers
Interface	public interface IBrowserManager extends IEventDispatcher

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Interface que l’instance partagée de l’objet BrowserManager implémente. Les applications écoutent les événements, appellent les méthodes et accèdent aux propriétés sur l’instance partagée qui est accessible avec la méthode BrowserManager.getInstance().

Eléments de l’API associés

mx.managers.BrowserManager

Propriétés publiques

	Propriété		Défini par
		base : String [lecture seule] Portion de l’URL actuelle avant le ’#’, telle qu’elle apparaît dans la barre d’adresse du navigateur.	IBrowserManager
		fragment : String [lecture seule] Portion de l’URL actuelle après le ’#’, telle qu’elle apparaît dans la barre d’adresse du navigateur.	IBrowserManager
		title : String [lecture seule] Titre de l’application, tel qu’il doit apparaître dans l’historique de navigation.	IBrowserManager
		url : String [lecture seule] URL actuelle, telle qu’elle apparaît dans la barre d’adresse du navigateur.	IBrowserManager

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.	IEventDispatcher
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	IEventDispatcher
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.	IEventDispatcher
		init(value:String = null, title:String = null):void Initialise l’objet BrowserManager.	IBrowserManager
		initForHistoryManager():void Initialise l’objet BrowserManager.	IBrowserManager
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	IEventDispatcher
		setFragment(value:String):void Change le fragment de l’URL après le ’#’ dans le navigateur.	IBrowserManager
		setTitle(value:String):void Change le texte dans la barre de titre du navigateur.	IBrowserManager
		willTrigger(type:String):Boolean Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.	IEventDispatcher

Evénements

Cliquez pour plus d’informations sur les événements

	Synthèse	Défini par
browserURLChange	Distribué lorsque l’URL est modifiée par le navigateur.	IBrowserManager
change	Distribué lorsque l’URL est modifiée par l’interaction de l’utilisateur avec le navigateur, par l’invocation d’une application dans AIR par l’utilisateur ou par la définition de la propriété par programme.	IBrowserManager
urlChange	Distribué lorsque l’URL est modifiée par l’application.	IBrowserManager

Détails de la propriété

base

propriété

base:String [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Portion de l’URL actuelle avant le ’#’, telle qu’elle apparaît dans la barre d’adresse du navigateur.

Implémentation
public function get base():String

fragment

propriété

fragment:String [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Portion de l’URL actuelle après le ’#’, telle qu’elle apparaît dans la barre d’adresse du navigateur. Utilisez la méthode setURLFragment() pour changer cette valeur.

Implémentation
public function get fragment():String

title

propriété

title:String [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Titre de l’application, tel qu’il doit apparaître dans l’historique de navigation.

Implémentation
public function get title():String

url

propriété

url:String [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

URL actuelle, telle qu’elle apparaît dans la barre d’adresse du navigateur.

Implémentation
public function get url():String

Détails de la méthode

init

()

méthode

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

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Initialise l’objet BrowserManager. L’objet BrowserManager recevra l’URL initiale. S’il possède un fragment, il distribue un événement BROWSER_URL_CHANGE. Cette méthode définit la valeur de la propriété ApplicationGlobals.application.historyManagementEnabled sur false, car le gestionnaire d’historique interfère généralement avec la gestion des fragments d’URL de votre application.

Paramètres

	`value:String` (default = `null`) — Fragment à utiliser si aucun fragment ne se trouve dans l’URL initiale.

	`title:String` (default = `null`) — Titre à utiliser si aucun fragment ne se trouve dans l’URL initiale.

initForHistoryManager

()

méthode

public function initForHistoryManager():void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Initialise l’objet BrowserManager. Le gestionnaire d’historique appelle cette méthode pour préparer l’objet BrowserManager à d’autres appels du gestionnaire d’historique. Vous ne pouvez pas utiliser le gestionnaire d’historique et appeler la méthode setFragment() depuis l’application. Par conséquent, la méthode init() définit généralement la valeur de la propriété ApplicationGlobals.application.historyManagementEnabled sur false pour désactiver le gestionnaire d’historique.

setFragment

()

méthode

public function setFragment(value:String):void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Change le fragment de l’URL après le ’#’ dans le navigateur. Une tentative de suivi de cette URL dans l’historique de navigation sera effectuée.

Si le titre est défini, l’ancien titre dans le navigateur est remplacé par le nouveau.

Pour stocker l’URL, une méthode JavaScript du nom de setBrowserURL() sera appelée. Le wrapper HTML de l’application doit posséder cette méthode qui doit implémenter un mécanisme pour prendre cette valeur et l’enregistrer avec le schéma d’historique et la barre d’adresse du navigateur.

Lorsque cela est défini, l’événement APPLICATION_URL_CHANGE est distribué. Si l’événement est annulé, la méthode setBrowserURL() n’est pas appelée.

Paramètres

value:String — Nouveau fragment à utiliser après le ’#’ dans l’URL.

setTitle

()

méthode

public function setTitle(value:String):void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Change le texte dans la barre de titre du navigateur. Cette méthode n’affecte pas l’historique de navigation.

Paramètres

value:String — Nouveau titre à utiliser dans la barre de titre du navigateur.

Détails de l’événement

browserURLChange

Evénement

Type d’objet d’événement: mx.events.BrowserChangeEvent
propriété BrowserChangeEvent.type = mx.events.BrowserChangeEvent.BROWSER_URL_CHANGE

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Distribué lorsque l’URL est modifiée par le navigateur.

La constante BrowserChangeEvent.BROWSER_URL_CHANGE définit la valeur de la propriété type de l’objet d’événement d’un événement browserURLChange.

Les valeurs des propriétés de l’objet d’événement sont les suivantes :

Propriété	Valeur
`bubbles`	false
`cancelable`	false
`currentTarget`	Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez `myButton.addEventListener()` pour enregistrer un écouteur d’événement, myButton est la valeur de `currentTarget`.
`lastURL`	Valeur précédente de la propriété `url` de la classe BrowserManager.
`target`	Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété `currentTarget`.
`url`	Nouvelle valeur de la propriété `url` de la classe BrowserManager.

change

Evénement

Type d’objet d’événement: flash.events.Event
propriété Event.type = flash.events.Event.CHANGE

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Distribué lorsque l’URL est modifiée par l’interaction de l’utilisateur avec le navigateur, par l’invocation d’une application dans AIR par l’utilisateur ou par la définition de la propriété par programme.

La constante Event.CHANGE définit la valeur de la propriété type de l’objet d’événement change.

Les propriétés de cet événement sont les suivantes :

Propriété	Valeur
`bubbles`	`true`
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`currentTarget`	L’objet qui traite activement l’objet Event avec un écouteur d’événements.
`target`	Objet dont la valeur a été modifiée. La propriété `target` ne correspond pas toujours à l’objet de la liste d’affichage qui est associé à l’écouteur d’événement. Utilisez la propriété `currentTarget` pour accéder à l’objet de la liste d’affichage qui traite actuellement l’événement.

urlChange

Evénement

Type d’objet d’événement: mx.events.BrowserChangeEvent
propriété BrowserChangeEvent.type = mx.events.BrowserChangeEvent.URL_CHANGE

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Distribué lorsque l’URL est modifiée par l’application.

La constante BrowserChangeEvent.URL_CHANGE définit la valeur de la propriété type de l’objet d’événement d’un événement urlChange.

Les valeurs des propriétés de l’objet d’événement sont les suivantes :

Propriété	Valeur
`bubbles`	false
`cancelable`	false
`currentTarget`	Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez `myButton.addEventListener()` pour enregistrer un écouteur d’événement, myButton est la valeur de `currentTarget`.
`lastURL`	Valeur précédente de la propriété `url` de la classe BrowserManager.
`target`	Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété `currentTarget`.
`url`	Nouvelle valeur de la propriété `url` de la classe BrowserManager.

Informations juridiques | Politique de confidentialité en ligne

IBrowserManager - AS3 Flex

Classes x

base

fragment

title

url

init

initForHistoryManager

setFragment

setTitle

browserURLChange

change

urlChange