ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
mx.managers 

HistoryManager  - AS3 Flex

Paketmx.managers
Klassepublic class HistoryManager
VererbungHistoryManager Inheritance Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die Verlaufsverwaltung ermöglicht Benutzern die Navigation durch eine Flex-Anwendung mithilfe der Vorwärts- und Zurück-Navigationsbefehle in einem Webbrowser.

Im Allgemeinen sollten Sie die BrowserManager-Klasse und tiefe Verlinkungen zur Statuserhaltung von Anwendungen sowie zur Bearbeitung von URLs und des Browserverlaufs verwenden. In bestimmten Fällen kann jedoch auch die HistoryManager-Klasse nützlich sein, beispielsweise bei der Verwaltung von älteren Flex-Anwendungen. Sie können die HistoryManager- und die BrowserManager-Klasse nicht in derselben Flex-Anwendung benutzen, auch wenn sie dieselben Unterstützungsdateien verwenden.

Die Verlaufsverwaltung ist standardmäßig für den Accordion- und den TabNavigator-Container aktiviert. Wenn Benutzer eines der Fenster in einem Accordion-Steuerelement auswählen, können sie also mit der Zurück-Schaltfläche oder dem entsprechenden Navigationsbefehl zum vorhergehenden Fenster zurückkehren. Die Verlaufsverwaltung ist standardmäßig für den ViewStack-Navigatior-Container deaktiviert.

Sie können die Verlaufsverwaltung deaktivieren, indem Sie die Eigenschaft historyManagementEnabled des Navigator-Containers auf false setzen.

Sie können außerdem die Verlaufsverwaltung für andere Objekte in einer Anwendung aktivieren, indem Sie die Objekte beim HistoryManager registrieren. Um eine Komponente bei der HistoryManager-Klasse zu registrieren, rufen Sie die register()-Methode der HistoryManager-Klasse mit einem Verweis auf eine Komponenteninstanz auf, die die IHistoryManagerClient-Schnittstelle implementiert. In dem folgenden Beispiel wird die Anwendungskomponente (this) bei der HistoryManager-Klasse registriert, sobald die Anwendung initialisiert wird:

  <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" 
    implements="mx.managers.IHistoryManagerClient" 
    initialize="mx.managers.HistoryManager.register(this);">
  
Außerdem müssen Sie die saveState()- und die loadState()-Methode der IHistoryManagerClient-Schnittstelle implementieren, um die Registrierung der Komponenten abzuschließen. UIComponent-Erweiterungskomponenten erben automatisch die loadState()-Methode.

Alle Methoden und Eigenschaften des HistoryManagers sind statisch, sodass Sie keine Instanz davon erstellen müssen.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
Öffentliche Methoden
 MethodeDefiniert von
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
  
[statisch] DEPRECATED: Initialisiert den HistoryManager.
HistoryManager
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
  
[statisch] Registriert ein Objekt beim HistoryManager.
HistoryManager
  
[statisch] Speichert den aktuellen Status der Anwendung, damit er später wiederhergestellt werden kann.
HistoryManager
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
  
[statisch] Macht die Registrierung eines Objekts beim HistoryManager rückgängig.
HistoryManager
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Methodendetails

initialize

()Methode
public static function initialize(sm:ISystemManager):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

DEPRECATED: Initialisiert den HistoryManager. Im Allgemein ist dieser Aufruf nicht erforderlich, da Flex diese Methode bei jedem Hinzufügen einer Komponente mit historyManagementEnabled aufruft. Ohne Initialisierung von der Anwendung auf oberster Ebene funktioniert der HistoryManager jedoch nicht richtig. Wenn Ihre Anwendung also über keine Komponenten verfügt, die für den HistoryManager aktiviert wurden, und untergeordnete Anwendungen lädt, bei denen das der Fall ist, müssen Sie die HistoryManager.initialize()-Methode in der Hauptanwendung aufrufen. Das geschieht normalerweise über eine initialize-Ereignisprozedur in der Anwendung.

Parameter

sm:ISystemManager — SystemManager für diese Anwendung.

register

()Methode 
public static function register(obj:IHistoryManagerClient):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Registriert ein Objekt beim HistoryManager. Das Objekt muss die IHistoryManagerClient-Schnittstelle implementieren.

Parameter

obj:IHistoryManagerClient — Zu registrierendes Objekt.

Verwandte API-Elemente

save

()Methode 
public static function save():void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Speichert den aktuellen Status der Anwendung, damit er später wiederhergestellt werden kann. Diese Methode wird automatisch von Navigator-Containern aufgerufen, wenn sich ihr Navigationsstatus ändert. Wenn Sie eine Schnittstelle mit dem HistoryManager registriert haben, müssen Sie die save()-Methode bei einer Statusänderung aufrufen.

unregister

()Methode 
public static function unregister(obj:IHistoryManagerClient):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Macht die Registrierung eines Objekts beim HistoryManager rückgängig.

Parameter

obj:IHistoryManagerClient — Objekt, für das die Registrierung rückgängig gemacht werden soll.





[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.