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

履歴管理を使用すると、ユーザーは 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 のメソッドとプロパティはすべて静的なので、そのインスタンスを作成する必要はありません。

関連項目

mx.managers.BrowserManager
mx.managers.IHistoryManagerClient
Using the HistoryManager


パブリックプロパティ
 プロパティ定義元
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
パブリックメソッド
 メソッド定義元
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
  
[静的] 非推奨 - HistoryManager を初期化します。
HistoryManager
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
  
[静的] オブジェクトを HistoryManager に登録します。
HistoryManager
  
[静的] アプリケーションの現在の状態を保存して、後で復元できるようにします。
HistoryManager
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
  
[静的] オブジェクトを HistoryManager から登録解除します。
HistoryManager
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
メソッドの詳細
initialize()メソッド
public static function initialize(sm:ISystemManager):void

非推奨 - HistoryManager を初期化します。 通常は、このメソッドを呼び出す必要はありません。historyManagementEnabled を使用してコンポーネントを追加すると常に、このメソッドが自動的に呼び出されるためです。 ただし、HistoryManager はトップレベルアプリケーションから初期化しないと、正しく機能しません。 アプリケーションに HistoryManager が有効になっているコンポーネントがないため、HistoryManager が有効になっているコンポーネントを持つ別のサブアプリケーションをロードする場合は、メインアプリケーションで HistoryManager.initialize() メソッドを呼び出す必要があります。通常これは、アプリケーションの initialize イベントハンドラから行います。

パラメータ

sm:ISystemManager — このアプリケーションの SystemManager です。

register()メソッド 
public static function register(obj:IHistoryManagerClient):void

オブジェクトを HistoryManager に登録します。 このオブジェクトは、IHistoryManagerClient インターフェイスを実装する必要があります。

パラメータ

obj:IHistoryManagerClient — 登録するオブジェクトです。

関連項目

save()メソッド 
public static function save():void

アプリケーションの現在の状態を保存して、後で復元できるようにします。 このメソッドは、ナビゲータコンテナのナビゲーション状態が変わると、ナビゲーターコンテナによって自動的に呼び出されます。 インターフェイスを HistoryManager に登録した場合は、アプリケーションの状態が変わったときに save() メソッドを呼び出す必要があります。

unregister()メソッド 
public static function unregister(obj:IHistoryManagerClient):void

オブジェクトを HistoryManager から登録解除します。

パラメータ

obj:IHistoryManagerClient — 登録解除するオブジェクトです。





 

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/mx/managers/HistoryManager.html