レイアウトの保存およびロードについて

xamDockManager コントロールは、レイアウト ファイルにもある現在のレイアウトからコンテンツ ペインを削除します。コンテンツ ペインが現在のレイアウトに存在するがレイアウト ファイルに存在しない場合、現在の位置のままになります。

xamDockManager コントロールは、レイアウト ファイルの情報に基づいて分割ペインおよびタブ グループ ペインを再作成します。デフォルト レイアウトの分割ペインまたはタブ グループ ペインに名前を付け、xamDockManager がレイアウト ファイルの同じ名前を持つ分割ペインまたはタブ ペインを見つけた場合、xamDockManager は再作成する代わりに分割ペインまたはタブ グループ ペインを再利用します。たとえば、「ペイン A」と「ペイン B」と名前が付けられた 2 つの垂直方向のコンテンツ ペインの分割ペインを含むレイアウトをエンド ユーザーが持っていると仮定します。アプリケーションの新しいバージョンで、新しいコンテンツ ペインを追加する決定をし、前述した分割ペインに「ペイン C」と名前を付けると、3 つの垂直方向のコンテンツ ペインがひとつの分割ペインに存在することになります。エンド ユーザーが「ペイン A」と「ペイン B」で情報を含むレイアウト ファイルをロードすると、xamDockManager のデフォルト動作は、現在の場所の「ペイン C」を離れ、「ペイン A」と「ペイン B」に新しい分割ペインを再作成します。このレイアウトは 2 つの垂直方向のペインがあるひとつの分割ペイン、「ペイン A」と「ペイン B」、そして「ペイン C」に個別の分割ペインを持つことになります。アプリケーションの前バージョンで分割ペインに名前を付けていた場合、レイアウト ファイルとアプリケーションのデフォルト レイアウトの両方が名前が付けられた分割ペインを持ちます。したがって、xamDockManager は、「ペイン A」と「ペイン B」に分割ペインを再作成する代わりに、この分割ペインを再利用します。レイアウトはひとつの分割ペインですべての 3 つのペインが垂直方向となります。

xamDockManager が手順 1 のコンテンツ ペインの中に見つからなかったレイアウト ファイルのコンテンツ ペインを発見する場合、xamDockManager は InitializePaneContent イベントを起動します。このイベントを処理し、欠落するコンテンツ ペインの SerializationId プロパティをチェックして、どのコンテンツを作成する必要があり、欠落するコンテンツ ペインを追加する必要があるかを確認できます。このイベント中にコンテンツを追加しなければ、xamDockManager は欠落するコンテンツ ペインをレイアウトに追加しません。たとえば、Microsoft® Visual Studio® にあるようなタブ付けされた編集機能を持つテキスト編集アプリケーションを作成する場合、エンド ユーザーが文書を開いた時に動的にタブ付けされた文書を作成する必要があります。エンド ユーザーが複数の文書を開き、レイアウトを保存し、アプリケーションを閉じると、次回にアプリケーションを起動してレイアウトをロードすると、アプリケーションのデフォルト レイアウトとエンド ユーザーのレイアウト ファイルに差分が生じます。レイアウト ファイルは文書タブに情報を持ち、デフォルト レイアウトにはこれらのタブはありません。したがって、xamDockManager は文書タブ毎に InitializePaneContent イベントを一度起動します。