| Package | mx.managers |
| Classe | public class HistoryManager |
| Héritage | HistoryManager  Object |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
En général, la classe BrowserManager et la liaison profonde vous permettent de conserver un état dans une application et de manipuler les URL et l’historique de navigation, mais la classe HistoryManager peut être utile dans d’autres circonstances, comme dans la gestion d’une application Flex héritée. Vous ne pouvez pas utiliser les classes HistoryManager et BrowserManager dans la même application Flex, même si elles utilisent le même jeu de fichiers de support.
La gestion d’historique est activée par défaut dans les conteneurs Accordion et TabNavigator. Cela signifie que si l’utilisateur sélectionne un des volets d’un contrôle Accordion, il peut renvoyer dans le volet précédent à l’aide du bouton Précédent du navigateur ou de la commande de navigation Précédent. La gestion d’historique est désactivée par défaut pour le conteneur de navigation ViewStack.
Vous pouvez désactiver la gestion d’historique en définissant la propriété historyManagementEnabled du conteneur de navigation sur false.
Vous pouvez également activer la gestion d’historique pour d’autres objets d’une application en enregistrant les objets avec la classe HistoryManager. Pour enregistrer un composant avec la classe HistoryManager, appelez la méthode register() de la classe HistoryManager avec une référence à une instance de composant qui implémente l’interface IHistoryManagerClient. Dans l’exemple suivant, le composant Application (this) est enregistré avec la classe HistoryManager lorsque l’application est initialisée :
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml"
implements="mx.managers.IHistoryManagerClient"
initialize="mx.managers.HistoryManager.register(this);">
Vous devez également implémenter les méthodes saveState() et loadState() de l’interface IHistoryManagerClient pour terminer l’enregistrement du composant. Les composants qui étendent l’objet UIComponent héritent automatiquement de la méthode loadState().
Toutes les méthodes et propriétés de la classe HistoryManager sont statiques. Vous n’avez donc pas besoin de leur créer une instance.
Eléments de l’API associés
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Méthode | Défini par | ||
|---|---|---|---|
 |
Indique si la propriété spécifiée d’un objet est définie. | Object | |
[statique]
DECONSEILLE. Initialise la classe HistoryManager. | HistoryManager | ||
|
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
[statique]
Enregistre un objet avec la classe HistoryManager. | HistoryManager | ||
[statique]
Enregistre l’état actuel de l’application afin de pouvoir le restaurer ultérieurement. | HistoryManager | ||
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
[statique]
Annule l’enregistrement d’un objet avec la classe HistoryManager. | HistoryManager | ||
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
initialize | () | méthode |
public static function initialize(sm:ISystemManager):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
DECONSEILLE. Initialise la classe HistoryManager. En général, il n’est pas nécessaire d’appeler cette méthode, car à chaque fois que vous ajoutez un composant avec historyManagementEnabled, Flex l’appelle. Toutefois, la classe HistoryManager ne fonctionne pas correctement si elle n’est pas initialisée à partir de l’application de niveau supérieur. Ainsi, si votre application ne comporte pas de composants activés par la classe HistoryManager et si elle charge d’autres sous-applications qui en comportent, vous devez appeler la méthode HistoryManager.initialize() dans l’application principale, généralement à partir d’un gestionnaire d’événement initialize de l’application.
Paramètres
sm:ISystemManager — SystemManager de cette application.
|
register | () | méthode |
public static function register(obj:IHistoryManagerClient):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Enregistre un objet avec la classe HistoryManager. L’objet doit implémenter l’interface IHistoryManagerClient.
Paramètres
obj:IHistoryManagerClient — Objet à enregistrer.
|
Eléments de l’API associés
save | () | méthode |
public static function save():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Enregistre l’état actuel de l’application afin de pouvoir le restaurer ultérieurement. Cette méthode est appelée automatiquement par les conteneurs de navigation à chaque fois que leur état de navigation change. Si vous avez enregistré une interface avec la classe HistoryManager, il est de votre ressort d’appeler la méthode save() lorsque l’état de l’application change.
unregister | () | méthode |
public static function unregister(obj:IHistoryManagerClient):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Annule l’enregistrement d’un objet avec la classe HistoryManager.
Paramètres
obj:IHistoryManagerClient — Objet dont l’enregistrement doit être annulé.
|
Tue Jun 12 2018, 09:30 AM Z