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

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ここでは、アプリケーションウィザードを使わずにビジュアル編集サーバーアプリケーションを作成する場合の、埋め込み先フレームウィンドウの実装方法について説明します。ここで説明する方法以外にも、アプリケーションウィザードで作成したアプリケーションまたは Visual C++ 付属のサンプルアプリケーションの既存の埋め込み先フレームウィンドウクラスを利用することもできます。

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

COleIPFrameWnd から派生した埋め込み先フレームウィンドウクラスを作成します。
- クラスヘッダーファイルで DECLARE_DYNCREATE マクロを使います。
- クラスの実装 (.cpp) ファイルで IMPLEMENT_DYNCREATE マクロを使います。これにより、埋め込み先フレームウィンドウクラスのオブジェクトが、フレームワークによって自動的に生成されます。
フレームウィンドウクラスのメンバ関数 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 を呼び出してオーナーを変更する必要があります。SetOwner を呼び出すと、コマンドの送り先がサーバーの埋め込み先フレームウィンドウに変更されるので、メッセージがサーバーに渡されます。この結果、サーバーがツールバーの操作に反応できるようになります。

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

詳細については、『MFC リファレンス』の「COleIPFrameWnd クラス」、「COleResizeBar クラス」、および「CDocTemplate::SetServerInfo」を参照してください。