ウィンドウの作成

CreateWindow関数

さて、いよいよウィンドウの作成の説明に入ります。
ウィンドウを作るにはCreateWindow関数を使用します。

HWND CreateWindowW(
 LPCWSTR lpClassName,
 LPCWSTR lpWindowName,
 DWORD dwStyle,
 int X,
 int Y,
 int nWidth,
 int nHeight,
 HWND hWndParent,
 HMENU hMenu,
 HINSTANCE hInstance,
 LPVOID lpParam
);

ウィンドウを作成する。
戻り値は作成したウィンドウのハンドル。
作成に失敗した場合はNULLを返す。

#include <windows.h>

int APIENTRY wWinMain(
	HINSTANCE hInstance,
	HINSTANCE hPrevInstance,
	LPWSTR lpCmdLine, 
	int nCmdShow)
{
	//ウィンドウ作成
	HWND hWnd = CreateWindow(
		L"STATIC", L"テストアプリ",
		WS_OVERLAPPEDWINDOW,
		100, 100,
		300, 300,
		NULL,
		NULL,
		hInstance,
		NULL
	);

	if (!hWnd)
	{
		//ウィンドウ作成の失敗
		return 0;
	}
	//作成したウィンドウの表示
	ShowWindow(hWnd, nCmdShow);

	MessageBox(NULL, L"ウィンドウアプリのテスト", L"タイトル", MB_OK);

	return 0;
}

このコードを実行すると以下のようなウィンドウが作られます。
同時にメッセージボックスが開き、OKを押下するとプログラムが終了します。
まだウィンドウを「作って表示しただけ」で、操作することはできません。

この関数は引数が多いので、順を追って説明します。

lpClassName

第一引数lpClassNameはウィンドウのクラス名を指定します。

ウィンドウクラスとは、ウィンドウの機能を決めるものです。
これは通常は自分で定義したものを使用します。
しかしまだその手順を説明していないので、ここではSTATICという文字列を指定しています。
これはWindowsが最初から用意しているクラス名(システムクラス)のひとつで、「STATIC」は単純な文字列を表示する機能を持つウィンドウです。
ウィンドウ作成の説明のためにとりあえずこのウィンドウクラスを使用します。

lpWindowName

第二引数のlpWindowNameはウィンドウのタイトルバーに表示される文字列です。
第一引数がSTATICの時、ウィンドウ内にも同じ文字列が表示されます。

dwStyle

第三引数dwStyleはウィンドウのスタイルを定数で指定します。
スタイルはウィンドウの見た目のほか、ウィンドウに対して可能な操作に関わります。
WS_OVERLAPPEDWINDOWは一般的なウィンドウアプリのスタイルです。
ここに指定できる定数は後でまとめて説明します。

X、Y、nWidth、nHeight

第四、第五、第六、第七引数は、デスクトップ画面の左上を基点(0, 0)としたウィンドウの位置とサイズの指定です。
Xは横位置、Yは縦位置です。
nWidthは横幅、nHeightは縦幅です。

ウィンドウが子ウィンドウの場合、親ウィンドウの左上が基点となります。

CW_USEDEFAULT

位置とサイズにはCW_USEDEFAULTという定数が使用できます。
位置やサイズに数値を指定すると、指定した通りの位置とサイズでウィンドウが起動します。
これでも構わないのですが、例えば同じアプリを複数同時に起動した場合に同じ位置とサイズにウィンドウが表示されることになり、少し使いづらいことがあります。
CW_USEDEFAULTを指定すると、現在開かれている別のウィンドウを基準にしてWindowsが適当な位置とサイズでウィンドウを生成してくれます。

特にこだわりがない場合はこの定数を指定したほうが良いでしょう。
ただしウィンドウスタイルによってはCW_USEDEFAULTが使用できず、0を指定したものとみなされます。

hWndParent

第八引数hWndParentは親ウィンドウ、またはオーナーウィンドウのウィンドウハンドルを指定します。
NULLを指定すると独立したウィンドウを作成します。

hMenu

第九引数hMenuはウィンドウが持つメニューを指定します。
メニューはあらかじめ作成しておく必要があります。
必要がない場合はNULLを指定します。

子ウィンドウを作成する場合はここに子ウィンドウID(整数値)を指定します。
このIDは親ウィンドウが子ウィンドウを識別するために使用します。

hInstance

第十引数hInstanceはウィンドウのインスタンスハンドルを指定します。
これはWinMain関数の引数で渡されるhInstanceをそのまま指定します。

インスタンスは「実体」という意味で、ハンドルはその(メモリ上の)位置を意味します。
WinMain関数の引数のhInstanceは、プログラム(実行ファイル)をメモリにロードした位置を表します。

インスタンスやハンドルなどの「中身」のデータが具体的にどうなっているかはプログラマは知る必要はありませんし、直接変更してはいけません。
操作する場合は専用の関数が用意されているので、それを使用します。

lpParam

最後のlpParamはウィンドウが作成される時に使用できる任意の値を指定します。
今は使用しないのでNULLを指定します。

戻り値

CreateWindow関数の戻り値は作成したウィンドウのハンドルです。
プログラムはこのウィンドウハンドルでウィンドウを識別します。
ウィンドウ作成に失敗した場合はNULLになります。

ShowWindow関数

CreateWindow関数が成功すればウィンドウが作成されます。
が、そのままではメモリ上に作成されただけであり画面には表示されません。
作成したウィンドウは初期状態では非表示なので、ShowWindow関数で表示する必要があります。

BOOL ShowWindow(
 HWND hWnd,
 int nCmdShow
);

ウィンドウhWndの表示状態をnCmdShowに変更する。
戻り値はウィンドウが表示状態だった場合は0以外を返す。
非表示常態だった場合は0を返す。

hWndには先ほど作成したウィンドウのハンドルを指定します。
nCmdShowは表示状態を表す以下の定数のいずれかを指定します。
ただし、アプリケーションが最初にShowWindow関数を呼び出す場合はWinMain関数の引数nCmdShowをそのまま渡す必要があります。

dwStyleの定数

CreateWindow関数の引数dwStyleは、ウィンドウのスタイルを指定する定数です。
以下はその定数の一覧です。

ウィンドウスタイル定数は「WS_○○」の形式です。
数も多く、ところどころ不明な用語もあるかと思いますが、今はあまり気にしなくて良いです。

なお、複数の定数を同時に指定する場合はビット演算のOR演算子を使用します。
(ビットとビット演算参照)

//WS_OVERLAPPEDWINDOWと同等の指定をビット演算子を使用して行う
HWND hWnd = CreateWindow(
	L"STATIC", L"テストアプリ",
	WS_OVERLAPPED | WS_CAPTION | WS_SYSMENU |
	WS_THICKFRAME | WS_MAXIMIZEBOX,
	CW_USEDEFAULT, CW_USEDEFAULT,
	CW_USEDEFAULT, CW_USEDEFAULT,
	NULL,
	NULL,
	hInstance,
	NULL
);

CreateWindowEx関数

ウィンドウの作成にはCreateWindowExという関数を使用することもできます。
これは第一引数に拡張ウィンドウスタイルが指定できる以外はCreateWindow関数と同じです。

HWND CreateWindowW(
 DWORD dwExStyle,
 LPCWSTR lpClassName,
 LPCWSTR lpWindowName,
 DWORD dwStyle,
 int X,
 int Y,
 int nWidth,
 int nHeight,
 HWND hWndParent,
 HMENU hMenu,
 HINSTANCE hInstance,
 LPVOID lpParam
);

ウィンドウを作成する。
戻り値は作成したウィンドウのハンドル。
作成に失敗した場合はNULLを返す。

CreateWindow関数の第一引数が拡張スタイルの指定になっています。
以降の引数はCreateWindow関数と同じものです。

拡張スタイルは以下の定数(の組み合わせ)が使用できます。

拡張ウィンドウスタイルの定数はすべて「WS_EX_○○」という形式です。

ウィンドウひとつ作るだけでかなりの情報量ですが、全てを把握する必要はありません。
とりあえずはサンプルコード通りのウィンドウを作成し、必要に応じていろいろと変更してみましょう。