[index] [詰め合わせ] [ダイアログボックス] [メニュー] [アクセラレータ] [String Table] [その他]

ダイアログボックス(dialog box)
リソーススクリプトでの。

　ダイアログボックスのテンプレートには、文法にのっとってスクリプトを記述しダイアログボックス本体のデザインをします。さらに、同様な記述によりコントロールを配置していきます。

　ボタンは、"押される" と、親ウィンドウのプロシージャ、つまり、ここでの場合は、ダイアログボックスのプロシージャに、WM_COMMAND が、ボタンのコントロールID といっしょになって、( wParam とか wp とか、つまりプロシージャ関数の第３引数、の下位16ビット(下位ワード)として含まれるかたちで) 送られます。

　他のコントロールも、なにか"出来事"があると、(主に)WM_COMMAND が、ボタンと全く同じように、コントロールのID といっしょに、送られます。

　説明する項目が多すぎるので、スケルトンコードのように骨格として使ってください。まるごと一つの .rc ファイルとすることが可能です。

  
#include <windows.h>
// #include <commctrl.h>
// #include "myprog.h"

#define IDC_LIST1   101
#define IDC_EDIT1   102
#define IDC_REPLACE 104
#define IDC_STATIC1 105
#define IDC_STATIC2 106
#define IDC_STATIC3 107

MYDIALOG1 DIALOGEX DISCARDABLE  -40, 20, 160, 100
STYLE WS_POPUP | WS_VISIBLE | WS_CAPTION | WS_SYSMENU |
      WS_SIZEBOX | WS_MAXIMIZEBOX |
      DS_SETFONT
EXSTYLE WS_EX_TOOLWINDOW
// MENU MYMENU1
CAPTION "ダイアログボックス１のタイトル"
FONT 14, "ＭＳ Ｐ明朝"
BEGIN

LISTBOX    IDC_LIST1 ,35   ,0  ,125 ,45 ,LBS_NOINTEGRALHEIGHT | LBS_WANTKEYBOARDINPUT | WS_VSCROLL | WS_HSCROLL
EDITTEXT   IDC_EDIT1 ,115  ,53 ,40  ,12 ,ES_AUTOHSCROLL
PUSHBUTTON "置換" ,IDC_REPLACE  ,15  ,53 ,31  ,12 ,0L

LTEXT      "すべては \"CONTROL\" キーワードで行えます。各キーワードの文法は微妙に違うので、使い分けるのが面倒な場合には CONTROL キーワードのみでいいでしょう。"
          ,IDC_STATIC1 ,5 ,68 ,135 ,24 ,SS_SUNKEN
CONTROL    "ほらね。"
          ,IDC_STATIC2 ,"STATIC" ,SS_LEFT | SS_SUNKEN
          ,115 ,67 ,30 ,12
CONTROL    IDI_ASTERISK
          ,IDC_STATIC3 ,"STATIC" ,SS_ICON
          ,8 ,7 ,21 ,21
END

　DIALOGEX キーワードは、 DIALOG キーワードが拡張されたものですが、文法はかわりません。面倒なので DIALOGEX キーワードを使用してしまいましょう。

　EXSTYLE WS_EX_TOOLWINDOW　はウィンドウ"拡張"スタイルの指定です。必要なければこれごと省略できます。WS_EX_　のかたちの拡張スタイル (フラグ) で指定します。

　"この色" と同じ色の部分は、リソーススクリプト内で一回だけ、先頭に必要です。

　0L は特に LONG型(32ビット) を指定しての、0 です。0 と記述しても構いません。

　MYDIALOG1 は自分でつけて良いメニューの名前です。数値やマクロ定数であることも可能です。その場合ソースプログラムでの扱いが異なります( MAKEINTRESOURCE() マクロの使用)。

　ダイアログボックスにメニューをつける場合も上例の MENU MYMENU1 のようにします。MYMENU1 メニューの定義(記述)はこの場所以前である必要はありません。

　※ CONTROL IDI_ASTERISK ,IDC_STATIC3 ,"STATIC" ,SS_ICON ,8 ,7 ,21 ,21
はスタティックコントロールのおもしろい(特殊な) 例です。表示文字列であるはずの部分が IDI_ASTERISK となっていますが例外的に OK です。(びっくりマークの)アイコンが表示できます。このほかにはあまり例外といえるものが存在しないので、しつこくなりましたが載せてみました。IDI_ASTERISK のほかの種類に関しては、LoadIcon() 関数のほか、 LoadBitmap() 関数などの説明をあたってみてください。

　[ ダイアログ本体のウィンドウスタイル ]
　STYLE WS_POPUP | WS_CAPTION |... の部分はダイアログボックス本体のウィンドウスタイルです。WS_ の形か DS_ の形のいずれかです。lcc のヘルプでは CreateWindow() 関数の説明(ヘルプ)に併せて載っています。 | はビットor 演算子で、いちおうは足し算の一種です。

　[ 座標と大きさ ]
　-40, 20, 160, 100 は、順に x, y, cx, cy。位置はマイナス(マイナスだと左(横方向)や上(縦方向)を表す) にもできるので少しおもしろくしました。単位はすべてダイアログユニット (DLU) という単位です。縦方向 1 DLU はフォント大 1/8 の、横方向 1 DLU はフォント大の 1/4 という定義です。

　縦は 8DLU 、横は 4DLU がそれぞれフォントの高さ、幅にあたることと同値です。DLU はフォントの大きさを基準とした単位です。だから、(下で説明する)フォントやその大きさを変えると、 DLU の表す大きさも変化し、つまりダイアログボックスの大きさが全体的に縮小拡大することになります。

　[ フォント ]
　FONT 14, "ＭＳＰ明朝" で、14　はポイントという単位の大きさで、もとは印刷業界の単位。"ＭＳＰ明朝" はフォントフェイス (face name) 。空白があるものは半角や全角も正確でないといけません。システムにインストールされているフォントフェイスです。フォントはなかなか資料としてまとまったものが少なく、探しにくいので、数もたいしたことないし、少し挙げてみましょう (日本語フォントのみ。ここでは挙げませんが英字フォントは面白いのがたくさんあります。)

"ＭＳゴシック" "ＭＳ明朝" "ＭＳＰゴシック" "ＭＳＰ明朝" "MS UI Gothic" "HGPｺﾞｼｯｸE" "HGPｺﾞｼｯｸM" "HGP教科書体" "HGP行書体" "HGP祥南行書体" "HGP正楷書体" "HGP創英ﾌﾟﾚｾﾞﾝｽEB" "HGP創英角ｺﾞｼｯｸUB" "HGP創英角ﾎﾟｯﾌﾟ体" "HGP明朝B" "HGP明朝E" [... HGSシリーズ略...] "HG丸ｺﾞｼｯｸM-PRO" "HG正楷書体-PRO" など。

　自分のコンピュータでどんなフォントが使えるかは、ChooseFont() 関数で "フォント選択ダイアログ" を出してみるとか、また EnumFontFamilies() 関数も利用できます。

　[ コントロール ]
　コントロールの貼り付けには、CONTROL キーワードを使うのが一番標準的です。全てのコントロールはこのキーワードで作成できます。

CONTROL "ほらね。",IDC_STATIC2 ,"STATIC" ,SS_LEFT | SS_SUNKEN ,115 ,7 ,30 ,6

CONTROL の次から順に、"表示文字列" , コントロールID , "ウィンドウクラス名" , ウィンドウ(の)スタイル , 座標(x4) と続きます。

この例はスタティックコントロールです。文字を表示するだけのコントロール。

　"コントロールに(デフォルトで)表示される文字列" はコントロールによっては関係のない場合があります。そのときは単に、"" などとします。文法的なきまりなので省略はできません。コントロールID は下記。ウィンドウクラス名はウィンドウ(コントロール)の種類です。ウィンドウスタイルについてはそれぞれのコントロールの説明を参照します。複数のスタイルは　ビットor 演算子 | で足していきます。座標の単位は DLU です。

　※ 表示される文字を動的に変えるには SetWindowText() 関数や SetDlgItemText() 関数をつかってみよう。

　[ 特別に構文が用意されたコントロール ]
　CONTROL キーワードを使っても作成できるものですが、特別にキーワードと構文が用意されたものがあります。上の例で CONTROL を使っていないアイテムはすべてこれです。LISTBOX はウィンドウクラス名に "LISTBOX"、 EDITTEXT は、"EDIT"、 PUSHBUTTON は "BUTTON" と BS_PUSH スタイル(フラグ)、LTEXT は "STATIC" と SS_LEFT フラグを使えば、従来どおり CONTROL によって作成できます。

　[ コントロールID (番号) ]
　別のダイアログボックスのコントロール同士でコントロールID が重複することは、アプリケーション上は問題ありません。特に一意の値を付けたい特別なコントロールを除いては、その点を利用してきれいに ID を付けていくのがいいです。そのほかの要点は [メニュー] のときとほぼ同じなので、そちらを参照してみてください。WM_COMMAND と LOWORD(wp)。

　[ 情報の所在 ]
　ダイアログボックスは、ウィンドウスタイルやコントロールアイテムのこともあるので、情報が分散していて慣れないとかなりやりづらい。

　[MSDN] ダイアログボックス本体の、リソーススクリプトに関すること。注１
　[MSDN] コントロールのウィンドウクラス名。注２
　[MSDN] ウィンドウスタイル。注３

　注１ CONTROLや DIALOG, DIALOGEX をあたってみてください。Controls 以下には、特別に構文のあるコントロールもあります。でもかなり分かりづらいです。
　注２各コントロールのウィンドウスタイルやメッセージもここ。ただしうまいぐあいに一覧にまとまったものが MSDN にはありません。[ここに一覧を載せたので参考にしてください]
　注３ WS_ のみなのでかなり不自由です。
　※ [データベース]

　※ lcc のヘルプを持っていれば、各コントロールのウィンドウスタイルや、WS_ と DS_ は CreateWindow() 関数、WS_EX_ に関しては CreateWindowEx() のところに載っているので非常に便利です。bcc についてくる grep.exe を使って、ヘッダファイル winuser.h や commctrl.h にむかって、"grep WS_ winuser.h" などとやるのも有効な手段です。

　[ 最後に。どうやって使うか ]
　CreateDialog() 関数をはじめとする、ダイアログボックス作成関数によって、

CreateDialog( GetModuleHandle(NULL) , "MYDIALOG1" , NULL , (DLGPROC)MyDlgProc ) ;

　のようにします。

　"MyDlgProc" はダイアログボックスのプロシージャの "関数アドレス" を指定しています。ということはつまり MyDlgProc() 関数 (ダイアログボックスプロシージャ) の記述が必要です。この関数のプロトタイプや仕様に関しては、標準的には、"DialogProc" という名前で統一されて説明されています。CreateDialog() の説明からでもたどれるでしょう。

　[ フォントの変更 ]
　フォントはどのコントロールにも、テンプレートで指定したフォントが共通して使われます。あるコントロールだけフォントを変更したい場合は、~~SelectObject() 関数 : 違います~~ や WM_SETFONT メッセージか、または SetWindowFont() マクロ ( <windowsx.h> にあります。これが一番楽 ) を利用します。この処理を行うタイミングは結局 WM_INITDIALOG くらいしか考えられません。フォントの作成には CreateFontIndirect() 関数などを使います。作ったフォントは、そのコントロールの破棄時に DeleteObject() することを忘れずに。ウィンドウ表示中に選択したフォントを DeleteObject() すると、文字が乱れますョ(実験するのが一番よいかもしれません)。

　
　[ おまけ : ダイアログプロシージャ ]
　ソースプログラムに記述するダイアログプロシージャは、簡単には以下で動作 OK です。たいそう簡単です。仮に急いで一回試してみたらすぐ、この関数に switch (msg) {... 文を加えて、WM_INITDIALOG や WM_COMMAND メッセージの処理部分を書きましょう。やっとプログラミングのはじまりです。[おまけリンクMSDNのダイアログ]

 
LRESULT CALLBACK MyDlgProc( HWND, UINT, WPARAM, LPARAM ); // プロトタイプ宣言
LRESULT CALLBACK MyDlgProc( HWND hWnd, UINT msg, WPARAM wp, LPARAM lp)  // 関数の本体
{ return FALSE ; }

[トップ] [level4：言葉] [index]