Hello Win32 之疯狂注释版

回想刚刚学习WIN32编程的时候，打开《windows程序设计》这本书，书中给的第一段代码就是一个Hello Win32的小程序。看得我头大，书中讲解的很详细，几乎每行代码都给了解释。但解释归解释，我一行一行的琢磨这些代码，还是不知道它们是什么意思。于是我把代码一行一行的敲到了编译器里，并找着书上的讲解，给每行代码都标上了长长的、详细的注释。尽管有的注释写上去后我还是不懂，但总算完成了这个Hello Win32 之疯狂注释版。今天翻出来，贴上来纪念一下。

#include <windows.h> LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM);//声明窗口过程函数，后面有定义int WINAPI WinMain(HINSTANCE hInstance,//程序入口点WinMain函数，第一个参数为程序实例句柄，用于标识该程序，第二个参数用于同一程序多次运行时的标识，但在WIN32中不再使用，为NULLHINSTANCE hPrevInstance,//第三个参数为程序运行参数，第四个参数为程序运行的初始状态，最小化、正常或最大化LPSTR lpCmdLine,int nShowCmd){static TCHAR szAppName[]=TEXT("HelloWin!");//定义一个字符串保存程序的名字，自由定义HWND hwnd;//定义一个句柄，以备后面创建窗体时使用MSG msg;//定义一个消息结构，用于后面的消息循环WNDCLASS wndclass;//定义一个窗口类结构体，该结构体名为wndclass，并在下面几行设置该结构体内的数据wndclass.style=CS_HREDRAW|CS_VREDRAW;//CS_HREDRAW为水平方向尺寸，CS_VREDRAW为垂直方向尺寸，这两个标识用于后面调整窗体大小时，中央文本任然能显示在中央wndclass.lpfnWndProc=WndProc;//将这个窗口类的过程设置为WndProc过程函数，这个过程处理基于这个窗口类创建的所有窗口的全部消息，lpfnWndProc为指向WndProc函数的指针wndclass.cbClsExtra=0;//用于在类结构和windows内部保存的窗口结构中预留一些额外空间，程序可以根据需要来使用预留的空间wndclass.cbWndExtra=0;//同上wndclass.hInstance=hInstance;//程序的实例句柄，由于该窗口属于该程序，这里与WinMain函数中的第一个参数一致wndclass.hIcon=LoadIcon(NULL,IDI_APPLICATION);//加载图标供程序使用，这里使用系统自带的预先定义的图标，第一个参数为NULL，第二个参数IDI_APPLICATION是一个简单的窗口小图形的图标，如果要用自己准备的图标，第一个参数为程序实例句柄hInstance，第二个参数标识图标wndclass.hCursor=LoadCursor(NULL,IDC_ARROW);//加载鼠标指针供程序使用，LoadCursor函数加载一个预先定义的鼠标光标，光标样式为IDC_ARROW，并返回该光标的句柄，这样，当我们将鼠标放到窗体客户区上时，鼠标变成一个小箭头，如果第二参数是其他样式，则鼠标放在窗体客户区上时，显示不一样的光标wndclass.hbrBackground=(HBRUSH)GetStockObject(WHITE_BRUSH);//获取绘制窗口背景的刷子，GetStockObject函数返回一个刷子句柄，参数WHITE_BRUSH为白色刷子，所以这里返回白色刷子句柄，也可以设置其他颜色，这决定着窗口客户区的背景颜色wndclass.lpszMenuName=NULL;//指定窗口类菜单，这里不需要菜单，为空wndclass.lpszClassName=szAppName;//设置一个类名，自由定义，这里我们定义为开头定义的szAppName[]RegisterClass(&wndclass);//注册刚刚定义的窗口类hwnd=CreateWindow(szAppName,//根据窗口类创建一个窗口，返回一个窗口句柄保存在hwnd里，同时下面的参数指定有关该窗口的更详细的信息，第一个参数为程序注册的窗口类名称TEXT("The Hello Program"),//第二个参数为窗口标题栏的内容WS_OVERLAPPEDWINDOW,//第三个参数为窗口风格，这里WS_OVERLAPPEDWINDOW是一种标准的窗口风格，它有一个标题栏，标题栏左边有一个系统菜单框，标题栏右边有最小化、最大化和关闭按钮，四周还有表示窗口大小的边框CW_USEDEFAULT,//第四个参数为窗口在屏幕上的水平位置，这里使用默认位置CW_USEDEFAULT,//第五个参数为窗口在屏幕上的垂直位置，这里也使用默认位置CW_USEDEFAULT,//第六个参数为窗口宽度，这里使用默认值CW_USEDEFAULT,//第七个参数为窗口高度，这里也使用默认值NULL,//第八个参数为父窗口句柄，由于这个程序只有一个窗口，这个窗口就是最高级窗口，所以这里留空NULL,//第九个参数为窗口菜单句柄，这里没有菜单，也留空hInstance,//第十个参数为程序实例句柄，与前面一样都为hInstanceNULL);//最后为创建参数指针为空，可以用这个指针访问以后想要引用的程序中的数据ShowWindow(hwnd,nShowCmd);//在屏幕上显示该窗口，参数hwnd即为刚刚创建好的窗口的句柄，nShowCmd即WinMan函数的第四个参数，决定窗口初始的状态，正常、最小化或最大化UpdateWindow(hwnd);//使窗口刷新自身while(GetMessage(&msg,NULL,0,0))//进入消息循环，GetMessageb函数没执行一次从消息队列中取出一个消息，参数NULL,0,0表示程序接受属于它的所有窗口的所有消息{TranslateMessage(&msg);//将msg结构传给windows，转换一些键盘消息DispatchMessage(&msg);//该函数将msg结构传给windows，然后windows将该消息发送给适当的窗口过程，让它处理，本程序中窗口过程即WndProc函数}return msg.wParam;//当退出消息消息循环后，返回msg结构的wParam数据，该数据是传递给PostQuitMessage函数的值（通常是0）}LRESULT CALLBACK WndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM IParam) //定义窗口过程，窗口过程确定了再窗口的客户区域显示什么，以及窗口怎样响应用户的输入{//第一个参数hwnd是接收消息的窗口的句柄，第二个参数message是标识该消息的数字，第三四个参数为32位的消息参数，提供关于消息的更多信息HDC hdc;//定义一个设备描述表句柄,这里指显示输入设备句柄PAINTSTRUCT ps;//该结构体内包含一些窗口过程，用来刷新窗口客户区的内容RECT rect;//定义一个RECT结构体，用于后面保存窗口客户区域的尺寸switch(message)//处理消息，这里我们定义的WndProc窗口过程函数只处理两种消息{case WM_PAINT://当我们调整窗口边框时，整个窗口将变成无效的，窗口过程将收到此WM_PAINT消息，接下来我们需要重新绘制窗口，这也是使得中央文本能一直保持在中央的原因hdc=BeginPaint(hwnd,&ps);//开始窗口绘制，第一个参数为程序的窗口句柄，第二个参数为指向PAINTSTRUCT结构体的指针，该结构体内包含一些窗口过程，用来刷新窗口客户区的内容。BeginPaint函数返回一个设备描述表句柄，保存在hdc里GetClientRect(hwnd,&rect);//获取窗口客户区的尺寸，第二个参数为之前定义的RECT结构体，用于保存窗口客户区域的尺寸DrawText(hdc,TEXT("Hello,Windows 7!"),-1,&rect,//显示窗口中心文本，第一个参数为设备描述表句柄，第二个参数为要显示的字符串，第三个参数为-1，指示字符串是以字节0结束的，第三个参数是保存窗口客户区尺寸的结构体DT_SINGLELINE|DT_CENTER|DT_VCENTER);EndPaint(hwnd,&ps);//结束窗口绘制，参数同开始窗口绘制return 0;case WM_DESTROY://单击右上角关闭按钮时触发此消息PostQuitMessage(0);//在消息队列中插入一条“退出”消息，这使得WinMain函数退出消息循环，程序终止return 0;}return DefWindowProc(hwnd,message,wParam,IParam);//DefWindowProc为默认消息处理函数，窗口过程不处理的消息都传给该函数}