DLGCBR32 サンプル:ダイアログボックスへのツールバーとステータスバーの追加を示します

[アーティクル]
10/29/2009

DLGCBR32 サンプルでは、ダイアログボックスにステータスバーとツールバーを追加する方法を示します。また、MFC アプリケーションのメインウィンドウとしてモードレスダイアログボックスを使用するときの手法も示します。

MFC アプリケーションでは、ステータスバーやツールバーなどのコントロールバーをフレームウィンドウに追加できます。ただし、簡単なダイアログボックスを使用したユーザーインターフェイスで十分というアプリケーションも少なくありません。 MFC には、ダイアログボックスにコントロールバーを追加するための組み込みサポートは用意されていません。

セキュリティに関するメモ
このサンプルコードは概念を示すためのものであり、その概念に関連するコードのみを示しています。特定の環境について必ずしもセキュリティ要件を満たしていませんので、そのまま使用しないでください。セキュリティおよびエラー処理コードを追加して、プロジェクトをより安全かつ堅牢にすることをお勧めします。これらのサンプルコードは、現状有姿のままで提供されるものであり、一切保証されていません。

このサンプルコードは概念を示すためのものであり、その概念に関連するコードのみを示しています。特定の環境について必ずしもセキュリティ要件を満たしていませんので、そのまま使用しないでください。セキュリティおよびエラー処理コードを追加して、プロジェクトをより安全かつ堅牢にすることをお勧めします。これらのサンプルコードは、現状有姿のままで提供されるものであり、一切保証されていません。

サンプルとそのインストール手順を取得するには

Visual Studio のサンプルにアクセスするには

[ヘルプ] メニューの [サンプル] をクリックします。

既定では、これらのサンプルは drive:\Program Files\Microsoft Visual Studio 10.0\Samples\ にインストールされています。

このサンプルの最新版および他のサンプルの一覧については、MSDN Web サイト上で Visual Studio サンプル」を参照してください。

サンプルのビルドと実行

DLGCBR32 サンプルをビルドおよび実行するには

ソリューション Dlgcbr32.sln を開きます。
[ビルド] メニューの [ビルド] をクリックします。
でデバッグ メニューの、[デバッグなしで開始をクリックします。

ダイアログボックスへのコントロールバーの追加

ダイアログボックスにコントロールバーを追加するには、通常どおりにコントロールバーを作成し、ダイアログボックスのクライアント領域にコントロールバーを配置します。コントロールバーを正しく機能させるためには、ダイアログボックスがフレームウィンドウの機能の一部を複製する必要があります。 ON_UPDATE_COMMAND_UI ハンドラーは、コントロールバーを操作する場合は、コントロールバーの新しいクラスを派生し、 WM_IDLEUPDATECMDUI メッセージを処理する必要があります。ダイアログボックスは、アプリケーションのメインウィンドウではない場合は、WM_IDLEUPDATECMDUI メッセージダイアログボックスの上にボックスのコントロールバーを渡すには、親フレームウィンドウを変更する必要があります。

ダイアログボックスのクライアント領域にコントロールバーを配置するには、ダイアログボックスの OnInitDialog 関数で次の手順を実行します。

コントロールバーを作成します。 reposQuery の RepositionBars オプションを使用して、コントロールバーが使用する領域を調べます。

CRect rcClientStart;
CRect rcClientNow;
GetClientRect(rcClientStart);
RepositionBars(AFX_IDW_CONTROLBAR_FIRST,
               AFX_IDW_CONTROLBAR_LAST,
               0, reposQuery, rcClientNow);

クライアント領域の上部または左側に配置するコントロールバーの領域を確保するために、ダイアログボックス内のコントロールを移動します。ダイアログボックスにメニューが含まれている場合は、メニューに必要な領域も確保します。

CPoint ptOffset(rcClientNow.left - rcClientStart.left,
                rcClientNow.top - rcClientStart.top);
CRect rcChild;
CWnd* pwndChild = GetWindow(GW_CHILD);
while (pwndChild)
    {
       pwndChild->GetWindowRect(rcChild);
       ScreenToClient(rcChild);
       rcChild.OffsetRect(ptOffset);
       pwndChild->MoveWindow(rcChild, FALSE);
       pwndChild = pwndChild->GetNextWindow();
    }

コントロールバーが使用する領域に応じて、ダイアログボックスウィンドウを大きくします。

CRect rcWindow;
GetWindowRect(rcWindow);
rcWindow.right += rcClientStart.Width() - rcClientNow.Width();
rcWindow.bottom += rcClientStart.Height() - rcClientNow.Height();
MoveWindow(rcWindow, FALSE);

RepositionBars を使用してコントロールバーを配置します。

最初のウィンドウのステータスバーのメニュー項目のテキストを更新するのには、ダイアログボックスクラスに WM_MENUSELECTWM_ENTERIDLEWM_SETMESSAGESTRINGWM_POPMESSAGESTRING を処理する必要があります。これらのメッセージのために CFrameWnd ハンドラーの機能を複製する必要があります。 CModelessMain クラスのサンプルプログラムにこれらのメッセージハンドラーの例」を参照してください。

ツールバーのボタンに対するツールヒントを表示するのには、TTN_NEEDTEXTWTTN_NEEDTEXTA 通知を処理する必要があります。

ON_UPDATE_COMMAND_UI ハンドラーを他のステータスバーペイン、およびツールバーのボタンを動作させるには、コントロールバーの新しいクラスを派生し、メッセージハンドラー WM_IDLEUPDATECMDUI を実装する必要があります。 OnUpdateCmdUI の既定のコントロールバーの実装では、親ウィンドウがフレームウィンドウであると想定されるため、この処理を行う必要があります。ただし、OnUpdateCmdUI は、CCmdTarget ポインターだけを必要とする関数に親ウィンドウのポインターを渡すだけです。このため、ここで渡される親ウィンドウのポインターが OnUpdateCmdUI ポインターであるということを CFrameWnd に一時的に伝えると、コンパイラの必要条件を満たすことができます。たとえば、次のように公開されます。

LRESULT CDlgToolBar::OnIdleUpdateCmdUI(WPARAM wParam, LPARAM lParam)
{
   if (IsWindowVisible())
   {
      CFrameWnd* pParent = (CFrameWnd*)GetParent();
      if (pParent)
         OnUpdateCmdUI(pParent, (BOOL)wParam);
   }
   return OL;
}

WM_IDLEUPDATECMDUI メッセージのメインウィンドウ以外のダイアログボックスの上に渡すには、ダイアログのポインターをフレームウィンドウクラスに保存し、そのクラスで WM_IDLEUPDATECMDUI ハンドラーを作成します。ハンドラーが WM_IDLEUPDATECMDUI メッセージダイアログボックスを使って CWnd::SendMessageToDescendants 子ウィンドウを送信する必要があります。この後、フレームウィンドウ内のメッセージに対して、既定の処理を実行します。

注意

このサンプルを含む一部のサンプルには、Visual C++ のウィザード、ライブラリ、およびコンパイラの変更が反映されていませんが、必要なタスクを実行する方法は示されています。

参照

その他の技術情報

MFC サンプル

DLGCBR32 サンプル:ダイアログ ボックスへのツールバーとステータス バーの追加を示します