创建你的第一个Windows程序

第一个 Windows 程序

* 纯净版

#include

int WINAPI WinMain(
	HINSTANCE hInstance,
	HINSTANCE hPrevInstance,
	LPSTR lpCmdLine,
	int iShowCmd
)
{
	MessageBox(NULL, TEXT("Hello, Windows!"), TEXT("HelloMsg"), 1);
	return 0;
}

* 注释版

#include

int WINAPI WinMain(
	HINSTANCE hInstance,		// 当前实例的句柄，唯一标识了我们这个程序（在Windows程序中，句柄就是一个数值，用来标识某个东西）
	HINSTANCE hPrevInstance,	// 前一个实例的句柄（在Win32中，此概念已弃用，因此该参数总是NULL）
	LPSTR lpCmdLine,			// 命令行参数
	int iShowCmd				// 指明程序最初如何显示（正常显示、最大化到全屏、最小化到任务栏）
)
{
	MessageBox(					// 函数作用：弹出一个小窗口，主要用来显示一些短消息
		NULL,					// 窗口句柄，唯一标识这个窗口
		TEXT("Hello, Windows!"),// 要在信息框里面出现的文本字符串
		TEXT("HelloMsg"),		// 要在标题栏上显示的文本字符串
		1						// 选择按钮的类型
	);
	return 0;
}

/*
Windows API 中"类型"的命名规则：

	HINSTANCE: H + INSTANCE == handle + instance == 实例句柄
	LPSTR: L + P + STR == long + pointer + str == 长字符指针
	i == int
	sz == 以零结尾的字符串
	c == const == 常量
	s == static == 静态

*/

编码问题

• 早期 Windows 使用 ASCII 进行编码，对于美国自己来用，基本上足够了

• 随着计算机的发展，世界各国都想要自己的文字能够在计算机上表示

• 为了统一世界各国的字符编码问题，Unicode 诞生了

• 它是通过增加位的方式来扩充，由原来的7位，变成现在的16位（方案不同，会有所出入,但只会更多，不会更少）

• 可容纳的符号，由原来的2^{7=128，变成现在的2}16=65536（方案不同，会有所出入，但只会更多，不会更少）

• 使用 Unicode 也有缺点：就是用 Unicode 写的字符占用的空间，会比用 ASCII 写的字符所占用的空间大2倍

• 为此，人们希望最好能够创建两个版本的程序，让不同需求的人，拿最适合自己的那一个版本即可

• 于是，有了以下的设计：

使用 TCHAR.H 头文件，这个头文件提供了一系列的类型或函数的替代名称

一个命名为 _UNICODE 的标识符被定义了，在生成代码时

TCHAR 就自动变成 wchar_t，_tprintf 就自动变成 wprintf（w：width）

一个名为 _UNICODE 的标识符没有被定义，在生成代码时

TCHAR 就自动变成 char，_tprintf 就自动变成 printf

同样的道理，对于字符串而言，使用 _T("hello world") 或 _TEXT("hello world") 也能自动变化

#include
#include

int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nShowCmd)
{
	MessageBox(NULL, _T("你好，窗口！"), _T("信息窗口"), 0);
	return 0;
}

创建窗口

运行代码的时候：

• 打开项目属性。
• 导航到“链接器”>“输入”>“附加依赖项”。
• 在“附加依赖项”字段中添加 winmm.lib（如果列表中还没有的话）

* 纯净版

#include
LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM);

int WINAPI WinMain(
	HINSTANCE hInstance,
	HINSTANCE hPrevInstance,
	PSTR szCmdLine,
	int iCmdShow
)
{
	static TCHAR szAppName[] = TEXT("HelloWin");
	HWND		hwnd;
	MSG			msg;
	WNDCLASS	wndclass;

	wndclass.style			= CS_HREDRAW | CS_VREDRAW;
	wndclass.lpfnWndProc	= WndProc;
	wndclass.cbClsExtra		= 0;
	wndclass.cbWndExtra		= 0;
	wndclass.hInstance		= hInstance;
	wndclass.hIcon			= LoadIcon(NULL, IDI_APPLICATION);
	wndclass.hCursor		= LoadCursor(NULL, IDC_APPSTARTING);
	wndclass.hbrBackground	= (HBRUSH)GetStockObject(WHITE_BRUSH);
	wndclass.lpszMenuName	= NULL;
	wndclass.lpszClassName	= szAppName;

	if (!RegisterClass(&wndclass))
	{
		MessageBox(NULL, TEXT("This program requires Windwos!"), szAppName, MB_ICONERROR);
		return 0;
	}

	hwnd = CreateWindow(
		szAppName,
		TEXT("The Hello Program"),
		WS_OVERLAPPEDWINDOW,
		CW_USEDEFAULT,
		CW_USEDEFAULT,
		CW_USEDEFAULT,
		CW_USEDEFAULT,
		NULL,
		NULL,
		hInstance,
		NULL
	);

	ShowWindow(hwnd, iCmdShow);
	UpdateWindow(hwnd);

	while (GetMessage(&msg, NULL, 0, 0))
	{
		TranslateMessage(&msg);
		DispatchMessage(&msg);
	}
	return msg.wParam;
}

LRESULT CALLBACK WndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)
{
	HDC hdc;
	PAINTSTRUCT ps;
	RECT rect;

	switch (message)
	{
	case WM_CREATE:
		PlaySound(TEXT("hellowin.wav"), NULL, SND_FILENAME | SND_ASYNC);
		return 0;

	case WM_PAINT:
		hdc = BeginPaint(hwnd, &ps);

		GetClientRect(hwnd, &rect);

		DrawText(hdc, TEXT("Hello, Windows!"), -1, &rect,
			DT_SINGLELINE | DT_CENTER | DT_VCENTER);

		EndPaint(hwnd, &ps);
		return 0;

	case WM_DESTROY:
		PostQuitMessage(0);
		return 0;
	}
	return DefWindowProc(hwnd, message, wParam, lParam);
}

* 注释版

#include

/* ------------------------------------------------------------------
	要创建窗口，首先需要注册一个窗口类，而窗口类又需要"窗口过程"来处理窗口消息
	名词解释：窗口过程，是一个函数，用于处理发送到类的所有窗口或发布到所有窗口的所有消息
	窗口过程是给 Windows 回调用的，它必须遵循规定的格式
	对窗口过程的子程序名并没有规定，对 Windows 来说，窗口过程的地址才是惟一需要的
------------------------------------------------------------------ */


// 声明"窗口过程"(窗口处理函数)，用于处理窗口消息
LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM);  // 窗口过程的名字，是可以自定义命名的


// Windows 程序的入口点
int WINAPI WinMain(
	HINSTANCE hInstance,		// 当前实例的句柄
	HINSTANCE hPrevInstance,	// 前一个实例的句柄（在Win32中，此参数总是NULL）
	PSTR szCmdLine,				// 命令行参数
	int iCmdShow				// 控制窗口如何显示
)
{
	static TCHAR szAppName[] = TEXT("HelloWin");	// 窗口类名
	HWND		hwnd;								// 窗口句柄
	MSG			msg;								// 消息结构体
	WNDCLASS	wndclass;							// 窗口类结构体

	// 设置窗口类的属性
	wndclass.style			= CS_HREDRAW | CS_VREDRAW;				// 窗口重绘风格
	wndclass.lpfnWndProc	= WndProc;								// 窗口过程（窗口处理函数）
	wndclass.cbClsExtra		= 0;									// 窗口类额外内存大小
	wndclass.cbWndExtra		= 0;									// 窗口实例额外内存大小
	wndclass.hInstance		= hInstance;							// 应用实例句柄
	wndclass.hIcon			= LoadIcon(NULL, IDI_APPLICATION);		// 加载默认图标
	wndclass.hCursor		= LoadCursor(NULL, IDC_APPSTARTING);	// 加载默认光标
	wndclass.hbrBackground	= (HBRUSH)GetStockObject(WHITE_BRUSH);	// 背景画刷
	wndclass.lpszMenuName	= NULL;									// 菜单名（这里没有使用）
	wndclass.lpszClassName	= szAppName;							// 窗口类名

	// 注册窗口类
	if (!RegisterClass(&wndclass))
	{
		MessageBox(
			NULL,
			TEXT("This program requires Windwos!"),
			szAppName,
			MB_ICONERROR
		);
		return 0;
	}

	// 创建窗口
	hwnd = CreateWindow(
		szAppName,					// 窗口类名
		TEXT("The Hello Program"),	// 窗口标题
		WS_OVERLAPPEDWINDOW,		// 窗口风格
		CW_USEDEFAULT,				// x坐标（使用默认值）
		CW_USEDEFAULT,				// y坐标（使用默认值）
		CW_USEDEFAULT,				// 宽度（使用默认值）
		CW_USEDEFAULT,				// 高度（使用默认值）
		NULL,						// 父窗口句柄（无父窗口）
		NULL,						// 菜单句柄（无菜单）
		hInstance,					// 应用实例句柄
		NULL						// 创建参数（这里不使用）
	);

	// 显示并更新窗口
	ShowWindow(hwnd, iCmdShow);
	UpdateWindow(hwnd);

	// 消息循环
	while (GetMessage(&msg, NULL, 0, 0))
	{
		TranslateMessage(&msg);		// 翻译消息（如键盘消息到字符消息）
		DispatchMessage(&msg);		// 分发消息到窗口过程（窗口处理函数）
	}
	return msg.wParam;
}


// 实现窗口过程（窗口处理函数）
LRESULT CALLBACK WndProc(
	HWND hwnd,			// 窗口句柄
	UINT message,		// 消息ID
	WPARAM wParam,		// 消息参数（对于某些消息，它表示特定的信息）
	LPARAM lParam		// 消息参数（对于某些消息，它通常是一个指向结构体的指针）
)
{
	HDC hdc;			// 设备上下文句柄，用于绘图操作
	PAINTSTRUCT ps;		// 绘图结构体，用于 BeginPaint 和 EndPaint 函数
	RECT rect;			// 矩形区域，用于描述窗口的绘图区域

	switch (message)
	{
	case WM_CREATE:						// 窗口创建消息
		PlaySound(						// 播放声音文件
			TEXT("hellowin.wav"),		// 声音文件的路径
			NULL,
			SND_FILENAME | SND_ASYNC	// SND_FILENAME表示通过文件名播放声音，SND_ASYNC表示异步播放（不阻塞程序）
		);
		return 0;

	case WM_PAINT:						// 窗口绘图消息
		hdc = BeginPaint(hwnd, &ps);	// 开始绘图

		GetClientRect(hwnd, &rect);		// 获取窗口客户区大小

		DrawText(
			hdc,
			TEXT("Hello, Windows!"),	// TEXT("Hello, Windows!"): 要绘制的文本字符串
			-1,							// -1: 字符串中的字符数。如果为-1，则函数会自动计算字符串长度 
			&rect,						// &rect: RECT结构体的指针，指定文本绘制的区域。文本将在这个矩形区域内被格式化
			DT_SINGLELINE | DT_CENTER | DT_VCENTER
			// DT_SINGLELINE | DT_CENTER | DT_VCENTER: 文本绘制选项
			// DT_SINGLELINE 表示文本将被格式化为单行
			// DT_CENTER 表示文本将在指定的矩形区域内水平居中
			// DT_VCENTER 表示文本将在指定的矩形区域内垂直居中
		);

		EndPaint(hwnd, &ps);			// 结束绘图
		return 0;

	case WM_DESTROY:					// 窗口销毁消息
		PostQuitMessage(0);				// 发出退出消息到消息队列
		return 0;
	}

	// 如果消息没有被窗口过程（WndProc）显式处理，则调用默认的窗口处理函数（DefWindowProc）来处理它
	return DefWindowProc(
		hwnd,		// hwnd: 窗口句柄，表示哪个窗口接收到了消息
		message,	// message: 消息ID，标识了要处理的消息类型
		wParam,		// wParam: 消息的参数之一，它的具体含义取决于消息类型
		lParam		// lParam: 消息的参数之二，它的具体含义也取决于消息类型
	);
}

常见的标识符前缀

常用的变量名前缀