メニューのマージ
コンテナー内のオブジェクトをアクティブにすると、OLE ドキュメントのメニューをマージするプロトコルによって、[ヘルプ] メニューがオブジェクト側で完全に制御されるようになります。 このため、ユーザーがオブジェクトを非アクティブにしない限り、コンテナーのヘルプ トピックが利用できなくなります。 Active ドキュメント コンテインメント アーキテクチャでは、埋め込み先編集用メニューのマージ規則が拡張され、コンテナーとアクティブな Active ドキュメントがメニューを共有できるようになりました。 新しい規則では、どのコンポーネントがメニューのどの部分を所有するのか、また共有メニューがどのように構築されるかが決定されます。
新しい規約の内容は簡単です。 Active ドキュメントでは、[ヘルプ] メニューは次のように 2 つのトップレベル メニュー項目から構成されます。
Help
Container Help >
Object Help >
たとえば、Office バインダーで Word セクションがアクティブな場合は、[ヘルプ]メニューは次のように表示されます。
Help
Binder Help >
Word Help >
任意の追加メニュー項目をコンテナーとオブジェクトに指定すると、どちらのメニュー項目もカスケード メニューになります。 表示されるメニュー項目は、コンテナーとオブジェクトによって異なります。
このマージされた [ヘルプ] メニューを作成するために、Active ドキュメント コンテインメント アーキテクチャは、標準の OLE ドキュメント プロシージャを変更します。 OLE ドキュメントでは、マージされたメニュー バーには、[ファイル]、[編集]、[コンテナー]、[Object]、[ウィンドウ]、[ヘルプ] の順に 6 つのメニュー グループが作成されます。 各グループには、複数のメニューがある場合も、まったくない場合もあります。 [ファイル]、[コンテナー]、 [ウィンドウ] はコンテナーに属し、[編集]、[オブジェクト]、[ヘルプ] はオブジェクトに属します。 オブジェクトがメニューをマージすると、空白のメニュー バーが作成されて、コンテナーに渡されます。 コンテナーは、IOleInPlaceFrame::InsertMenus を呼び出して、コンテナーのメニューを挿入します。 オブジェクトは、6 つの LONG 値型配列 (OLEMENUGROUPWIDTHS) 構造体も渡します。 メニューを挿入した後、コンテナーは各グループに追加したメニューの数をこの配列で返します。 次に、オブジェクトは各コンテナー グループに追加されたメニュー数を考慮し、オブジェクト側のメニューを挿入します。 最後に、オブジェクトはマージされたメニュー バーと、各グループのメニュー数を格納した配列を OLE に渡します。OLE は非透過な "メニュー記述子" ハンドルをオブジェクトに返します。 オブジェクトは IOleInPlaceFrame::SetMenu を呼び出して、このハンドルとマージ後のメニュー バーをコンテナーに渡します。 コンテナーはマージされたメニュー バーを表示し、ハンドルを OLE に渡します。これで、OLE がメニュー メッセージを適切にディスパッチできるようになります。
変更された Active ドキュメント プロシージャでは、オブジェクトはコンテナーに渡す前に、OLEMENUGROUPWIDTHS の全要素を 0 に初期化する必要があります。 コンテナーに 1 つの例外は通常メニュー挿入を実行します。コンテナーの挿入、に役立つ メニューの最後の項目としてとの最後の (6) エントリを 1 の値を格納、 OLEMENUGROUPWIDTHS配列 (オブジェクトのヘルプ グループに属する、幅 [5])。 この [ヘルプ] メニューには、サブメニューとして項目が 1 つだけあります。それは、前述の "[コンテナーのヘルプ]" というカスケード メニューです。
次に、オブジェクトは、通常のメニュー挿入コードどおりに処理を実行します。ただし、[ヘルプ] メニューを挿入する前に、OLEMENUGROUPWIDTHS 配列の 6 番目のエントリを調べます。 この値が 1 で、最後のメニュー名が "ヘルプ" の場合、オブジェクトはコンテナーの [ヘルプ] メニューのサブメニューとして自分の [ヘルプ] メニューを挿入します。
次に、オブジェクトは OLEMENUGROUPWIDTHS の 6 番目の要素を 0 に設定し、5 番目の要素の値を 1 増分します。 これにより、OLE はこの [ヘルプ] メニューがコンテナーに属しており、このメニューとサブメニューからのメニュー メッセージの送り先はコンテナーであると判断できるようになります。 この結果、オブジェクトの [ヘルプ] メニューからの WM_INITMENUPOPUP、WM_SELECT、WM_COMMAND などのメニュー関連メッセージは、コンテナーによって転送されます。 この処理は、ユーザーのポイントした位置がオブジェクトの [ヘルプ] メニューかどうかを示すフラグが、WM_INITMENU によってクリアされると実行されます。 コンテナーは、コンテナー側で追加しなかった [ヘルプ] メニュー項目へのポインターの出入りを WM_MENUSELECT で調べます。 ポインターの進入時、つまりユーザーがオブジェクト側メニューをポイントすると、コンテナーは "オブジェクト側 [ヘルプ] メニュー" フラグをオンにします。このフラグがセットされると、WM_MENUSELECT、WM_INITMENUPOPUP、WM_COMMAND メッセージなどがオブジェクト ウィンドウに転送されます。 ポインターがオブジェクト メニューから離れると、コンテナーはフラグをクリアし、メッセージをコンテナー側で処理します。コンテナーは、これらのメッセージの送り先として、オブジェクトの IOleInPlaceActiveObejct::GetWindow 関数から返されたウィンドウを使用します。
OLEMENUGROUPWIDTHS の 6 番目の要素値が 0 の場合、オブジェクトは OLE ドキュメントの通常の規則に従ってメニューを処理します。 つまり、[ヘルプ] メニューをマージするコンテナーもしないコンテナーも処理されます。
マージされたメニュー バーを表示する前にオブジェクトが IOleInPlaceFrame::SetMenu を呼び出した場合、コンテナーは、コンテナー側で追加したサブメニュー以外のサブメニューが [ヘルプ] メニューにあるかどうかを調べます。 ある場合は、コンテナーはその [ヘルプ] メニューをマージされたメニュー バーにそのまま残します。 [ヘルプ] メニューにほかのサブメニューがない場合は、その[ヘルプ] メニューをマージされたメニュー バーから削除します。 これにより、[ヘルプ] メニューをマージするオブジェクトもマージしないオブジェクトも処理されます。
メニューの逆アセンブリ時、オブジェクトは [ヘルプ] メニューなどのオブジェクト側で追加したすべてのメニューを削除します。 コンテナーが自分のメニューを削除する場合も、[ヘルプ] メニューなどのコンテナー側で追加したすべてのメニューを削除します。