サーバー : 埋め込み先フレームウィンドウの実装

[アーティクル]
07/19/2022

この記事では、アプリケーションウィザードを使用せずにサーバーアプリケーションを作成する場合に、埋め込み先フレームウィンドウを、ビジュアル編集サーバーアプリケーション内に実装する際に行う必要がある作業について説明します。この記事で説明する手順の代わりに、既存の埋め込み先フレームウィンドウクラスを、アプリケーションウィザードで生成されたアプリケーションまたは Visual C++ で提供されているサンプルから使用することもできます。

埋め込み先フレームウィンドウクラスを宣言するには

COleIPFrameWnd の埋め込み先フレームウィンドウクラスを派生させます。
- ご自身のクラスヘッダーファイル内で、DECLARE_DYNCREATE マクロを使用します。
- ご自身のクラス実装ファイル内で、IMPLEMENT_DYNCREATE マクロ (.cpp) を使用します。これにより、このクラスのオブジェクトをフレームワークで作成できます。
フレームウィンドウクラス内で COleResizeBar メンバーを宣言します。これは、サーバーアプリケーション内で埋め込み先サイズ変更をサポートする場合に必要です。

OnCreate メッセージハンドラーを宣言し (クラスウィザードを使用)、ご自身の COleResizeBar メンバーに対して Create を呼び出します (これを定義した場合)。

ツールバーがある場合は、フレームウィンドウクラス内で CToolBar メンバーを宣言します。

サーバーが埋め込み先でアクティブになっているときに、OnCreateControlBars メンバー関数をオーバーライドして、ツールバーを作成します。次に例を示します。

BOOL CInPlaceFrame::OnCreateControlBars(CFrameWnd* pWndFrame, CFrameWnd* pWndDoc)
{
   UNREFERENCED_PARAMETER(pWndDoc);

   // Set owner to this window, so messages are delivered to correct app
   m_wndToolBar.SetOwner(this);

   // Create toolbar on client's frame window
   if (!m_wndToolBar.CreateEx(pWndFrame, TBSTYLE_FLAT, WS_CHILD | WS_VISIBLE | CBRS_TOP
      | CBRS_GRIPPER | CBRS_TOOLTIPS | CBRS_FLYBY | CBRS_SIZE_DYNAMIC) ||
      !m_wndToolBar.LoadToolBar(IDR_SRVR_INPLACE))
   {
      TRACE0("Failed to create toolbar\n");
      return FALSE;
   }

   // TODO: Delete these three lines if you don't want the toolbar to be dockable
   m_wndToolBar.EnableDocking(CBRS_ALIGN_ANY);
   pWndFrame->EnableDocking(CBRS_ALIGN_ANY);
   pWndFrame->DockControlBar(&m_wndToolBar);

   return TRUE;
}

このコードについては、手順 5 の後の説明を参照してください。

メインの .cpp ファイルに、この埋め込み先フレームウィンドウクラスのヘッダーファイルを含めます。
アプリケーションクラスの InitInstance 内で、ドキュメントテンプレートオブジェクトの SetServerInfo 関数を呼び出して、オープンおよびインプレース編集で使用するリソースと埋め込み先フレームウィンドウを指定します。

if ステートメント内の一連の関数呼び出しによって、サーバーが提供するリソースからツールバーが作成されます。この時点で、ツールバーはコンテナーのウィンドウ階層の一部となります。このツールバーは CToolBar から派生しているため、所有者を変更しない限り、メッセージは、その所有者、コンテナーアプリケーションのフレームウィンドウに渡されます。そのため、SetOwner を呼び出す必要があります。この呼び出しによって、コマンドの送信先ウィンドウが、サーバーの埋め込み先フレームウィンドウに変更され、メッセージがサーバーに渡されます。これにより、サーバーは、そのサーバーが提供するツールバー上での操作に対応できます。

ツールバービットマップの ID は、ご自身のサーバーアプリケーション内で定義されている他の埋め込み先リソースと同じである必要があります。詳細については、「メニューとリソース: サーバーの変更点」を参照してください。

詳細については、「クラスライブラリリファレンス」の COleIPFrameWnd、COleResizeBar、CDocTemplate::SetServerInfo の各クラスに関するページをご覧ください。

サーバー : 埋め込み先フレーム ウィンドウの実装

埋め込み先フレーム ウィンドウ クラスを宣言するには

関連項目

サーバー : 埋め込み先フレームウィンドウの実装

埋め込み先フレームウィンドウクラスを宣言するには