HistoryManager  - AS3 Flex

パッケージ	mx.managers
クラス	public class HistoryManager
継承	HistoryManager Object

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

履歴管理を使用すると、ユーザーは Web ブラウザーの「戻る」および「進む」ナビゲーション機能を使用して、Flex アプリケーション内を移動できます。

一般に、アプリケーションの状態を維持し、URL およびブラウザー履歴を操作するには、BrowserManager クラスと深いリンクを使用する必要がありますが、古い Flex アプリケーションを維持する場合などの特定の状況では、HistoryManager クラスが役立ちます。 HistoryManager クラスと BrowserManager クラスを同じ Flex アプリケーション内で使用することはできません。これは、これらのクラスが同じサポートファイルのセットを使用する場合でも同じです。

Accordion コンテナおよび TabNavigator コンテナの履歴管理は、デフォルトで有効になっています。 すなわち、Accordion コントロールのいずれかのペインを選択した場合、ブラウザーの戻るボタンまたは「戻る」ナビゲーション機能を使用して前のペインに戻ることができます。 ViewStack ナビゲーターコンテナでは、履歴管理はデフォルトで無効になっています。

履歴管理を無効にするには、ナビゲーターコンテナの historyManagementEnabled プロパティを false に設定します。

他のオブジェクトも、HistoryManager に登録すれば、アプリケーションで履歴管理を有効にできます。 コンポーネントを HistoryManager クラスに登録するには、IHistoryManagerClient インターフェイスを実装するコンポーネントインスタンスへの参照を指定して、HistoryManager クラスの register() メソッドを呼び出します。 次の例では、Application コンポーネントの初期化時に、Application コンポーネント (this) を HistoryManager クラスに登録しています。

  <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" 
    implements="mx.managers.IHistoryManagerClient" 
    initialize="mx.managers.HistoryManager.register(this);">
  

コンポーネントの登録を完了するには、IHistoryManagerClient インターフェイスの saveState() メソッドおよび loadState() メソッドも実装する必要があります。 UIComponent を拡張するコンポーネントは、自動的に loadState() メソッドを継承します。

HistoryManager のメソッドとプロパティはすべて静的なので、そのインスタンスを作成する必要はありません。

関連する API エレメント

---