WinMain函数 注册窗口类 消息循环

#include <windows.h>
#pragma comment(lib,"winmm.lib")//为了要播放声音，必须导入这个库

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

int WINAPI WinMain (HINSTANCE hInstance, HINSTANCE hPrevInstance,PSTR szCmdLine, int iCmdShow)
/*
HINSTANCE 类型的含义为实例句柄。
hInstance 事实上就是当前应用程序自身的标识代号,代号通常都是一个32位整数。
hPrevInstance 与过去的16位应用程序有关系，表示指向前一个实例的句柄。

PSTR 类型的含义是指向以\0结尾的字符串指针。
szCmdLine 前面的sz同样是表示指向以\0结尾的字符串指针，这个对象用于保存命令行。

最后iCmdShow是一个整型数据，标记了程序最初的显示状态。
为SW_SHOWNORAML的时候为一般大小显示方式。
为SW_SHOWMAXIMIZED的时候为最大化显示方式。
为SW_SHOWMINNOACTIVE的时候程序将显示在任务栏上。
*/
{

static char szAppName[] = TEXT("HelloWin");//预先定义一个c风格字符串,稍后用于设置窗口类名称。
WNDCLASS wndclass;//定义窗口类对象
/*
在这里不得不说一下的是，窗口类事实上是struct结构体,内部有10个分量，他们是用来于初始化窗口类对象而用的。
这个结构体在winuser.h头文件中定义，从方式上来说，分为ASCII版的WNDCLASSA和Unicode版的WNDCLASSW两个。
typedef struct tagWNDCLASSA {
UINT style;
WNDPROC lpfnWndProc;
int cbClsExtra;
int cbWndExtra;
HINSTANCE hInstance;
HICON hIcon;
HCURSOR hCursor;
HBRUSH hbrBackground;
LPCSTR lpszMenuName;
LPCSTR lpszClassName;
} WNDCLASSA, *PWNDCLASSA, NEAR *NPWNDCLASSA, FAR *LPWNDCLASSA;
typedef struct tagWNDCLASSW {
UINT style;
WNDPROC lpfnWndProc;
int cbClsExtra;
int cbWndExtra;
HINSTANCE hInstance;
HICON hIcon;
HCURSOR hCursor;
HBRUSH hbrBackground;
LPCWSTR lpszMenuName;
LPCWSTR lpszClassName;
} WNDCLASSW, *PWNDCLASSW, NEAR *NPWNDCLASSW, FAR *LPWNDCLASSW;
*/

//------------------------------- 窗口类对象初始化过程 ------------------------------------ wndclass.style = CS_HREDRAW | CS_VREDRAW;
/*
设置窗口类对象的样式风格，CS_HREDRAW | CS_VREDRAW这两个值是通过位运算的与运算结合起来的。
表示了窗口在改变了水平和垂直大小的时候，窗口要强迫刷新。
这些通过define定义的标识，可以在WinUser.h头文件中找到。
#define CS_VREDRAW 0x0001
#define CS_HREDRAW 0x0002
#define CS_DBLCLKS 0x0008
#define CS_OWNDC 0x0020
#define CS_CLASSDC 0x0040
#define CS_PARENTDC 0x0080
#define CS_NOCLOSE 0x0200
#define CS_SAVEBITS 0x0800
#define CS_BYTEALIGNCLIENT 0x1000
#define CS_BYTEALIGNWINDOW 0x2000
#define CS_GLOBALCLASS 0x4000
#define CS_IME 0x00010000
*/

wndclass.lpfnWndProc = WndProc ;//指定窗口的处理函数为WndProc，WndProc将处理windows消息。
wndclass.cbClsExtra = 0;//窗口类无扩展
wndclass.cbWndExtra = 0;//窗口实例无扩展
wndclass.hInstance = hInstance;//指定当前应用程序实例句柄,也就是程序当前的标识号。
wndclass.hIcon = LoadIcon (NULL,IDI_APPLICATION);
/*
通过LoadIcon函数设置应用程序窗口标题的icon图标。
HICON LoadIcon(HINSTANCE hInstance,LPCTSTR lpIconName);
函数返回HICON类型的图标句柄。
第一个参数表示当前应用程序的窗口句柄,第二个参数表示图标。
默认状态下，第一个参数为NULL,第二个为IDI_APPLICATION,表示使用系统默认提供的图标，可以在WinUser.h头文件中找到。
#define IDI_APPLICATION 32512
*/
wndclass.hCursor = LoadCursor (NULL, IDC_ARROW) ;
/*
通过LoadCursor函数设置应用程序窗口光标样式。
HCURSOR LoadCursor(HINSTANCE hInstance,LPCTSTR lpCursorName);
函数返回HCURSOR类型的光标句柄。
第一个参数表示当前应用程序的窗口句柄,第二个参数表示光标。
默认状态下，第一个参数为NULL,第二个为IDC_ARROW,表示使用系统默认提供的光标，可以在WinUser.h头文件中找到。
#define IDC_ARROW MAKEINTRESOURCE(32512)
*/
wndclass.hbrBackground = (HBRUSH)GetStockObject (WHITE_BRUSH);
/*
通过GetStockObject函数设置应用程序窗口的背景颜色。
HGDIOBJ GetStockObject(int fnObject);
函数返回HCURSOR类型的GDI对象句柄，为了程序能够正确执行，必须把HGDIOBJ类型强制转换成HBRUSH画刷句柄。
参数表示当前使用的画刷颜色。
这些常量的定义可以在WinGDI.h头文件中找到。
#define WHITE_BRUSH 0
#define LTGRAY_BRUSH 1
#define GRAY_BRUSH 2
#define DKGRAY_BRUSH 3
#define BLACK_BRUSH 4
#define NULL_BRUSH 5
#define HOLLOW_BRUSH NULL_BRUSH
*/
wndclass.lpszMenuName = NULL;
wndclass.lpszClassName = szAppName;//窗口类对象的名称
//-----------------------------------------------------------------------------------------
RegisterClass (&wndclass);
/*
注册窗口类,参数为窗口类对象的指针。
函数原形为:
ATOM RegisterClass(CONST WNDCLASS *lpWndClass);
*/

//-------------------------- 实例化过程 -------------------------------------------------
HWND hwnd ; //创建用于保存窗口句柄的对象，窗口句柄是系统识别不同窗口的依据，它只是个代号。
hwnd = CreateWindow(
szAppName, // 窗口类名称
"你好世界", // 窗口标题
WS_OVERLAPPEDWINDOW, // 窗口样式
CW_USEDEFAULT, // 初始的窗口x轴位置
CW_USEDEFAULT, // 初始的窗口y轴位置
CW_USEDEFAULT, // 初始的窗口x轴大小
CW_USEDEFAULT, // 初始的窗口y轴大小
NULL, // 父窗口句柄
NULL, // 窗口功能表句柄
hInstance, // 应用程序实例句柄
NULL // 建立参数，这个参数可以存取后面程序中可能引用到的资料。
);
/*
在窗口类对象的初始化过程中，我们定义了窗口的一些简单一般特征，比如背景颜色呀，光标呀，等等。
但是在利用CreateWindow创建窗口的时候可以设置更多的细节，比如窗口标题这些。
函数原形如下：
HWND CreateWindow( LPCTSTR lpClassName,
LPCTSTR lpWindowName,
DWORD dwStyle,
int x,
int y,
int nWidth,
int nHeight,
HWND hWndParent,
HMENU hMenu,
HINSTANCE hInstance,
LPVOID lpParam
);
一旦窗口创建成功，那么CreateWindow将返回窗口句柄，也就是窗口代号，值保存在窗口句柄对象hwnd中。
*/
ShowWindow(hwnd, iCmdShow);
/*
在执行过CreateWindow函数后，在系统的内部窗口已经创建成功了。
但为了要把窗口显示在桌面上，我们还必须调用ShowWindow函数。
其函数原形如下：
BOOL ShowWindow(WND hWnd,int iCmdShow);
参数1是需要显示的窗口句柄，第二个则是传递给WinMain的iCmdShow,用来确定最开始窗口的显示方式。
在这里窗口的显示方式，主要是指最大化，最小化这些。
*/
UpdateWindow (hwnd);
/*
UpdateWindow这个函数的作用是用于重绘显示区域。
因为如果ShowWindow函数的iCmdShow从WinMain获得的参数是SW——SHOWNORMAL，那么窗口的显示区域就会被背景画刷覆盖，
调用UpdateWindow函数会通过发送给窗口消息处理函数WndProc一个WM_PAINT消息，通过这个消息完成重绘显示区域的工作。
*/
//-----------------------------------------------------------------------------------------
//---------------------------- 消息循环 -------------------------------------------------
/*
当调用过UpdateWindow函数后，窗口已经显示在了桌面屏幕上，接下来要做的工作是处理消息。
windows应用程序可以接受各种消息包括键盘，鼠标，等等。
windows是通过监视各种输入设备，把发生的事件转化为消息的，并将消息保存在消息队列中。
最后当前的应用程序从自己的消息队列中按顺序检索消息，并把每一个消息发送到所对应的窗口消息处理函数总去，这里是指WndProc。
*/
MSG msg ;//建立消息对象。
/*
MSG是个结构体类型，在WinUser.h头文件中可以找到。
typedef struct tagMSG{
HWND hwnd;//窗口句柄
UINT message;//消息识别字，在WinUser.h头文件中可以找到，以WM开头,这里就不全部举出来了。
WPARAM wParam;//32位的消息参数，其含义和值根据消息的不同而不同。
LPARAM lParam;//32位的消息参数，其值和消息无关。
DWORD time;//消息进入消息队列的时间。
POINT pt;//消息进入消息队列时候的鼠标坐标。
#ifdef _MAC
DWORD lPrivate;
#endif
} MSG, *PMSG, NEAR *NPMSG, FAR *LPMSG;
其中POINT也是个结构体类型,在WinDef.h头文件中可以找到

typedef struct tagPOINT
{
LONG x;
LONG y;
} POINT, *PPOINT, NEAR *NPPOINT, FAR *LPPOINT;
*/
while (GetMessage (&msg, NULL, 0, 0))
{
/*
我们通过这个循环代码来维护消息循环，循环的执行条件是通过GetMessage函数获得的。
函数原型如下：
BOOL GetMessage(LPMSG lpMsg,HWND hWnd,UINT wMsgFilterMin,UINT wMsgFilterMax);
参数一是一个指向msg对象的指针，剩余的参数为NULL或0表示程序接受它自己建立的所有窗口的消息。
windows从消息队列取出的下一个消息将填充MSG结构中的各成员分量。
*/
TranslateMessage (&msg);//把虚拟键盘消息转换到字符消息，满足键盘输入的需要，参数为msg消息对象的指针。
DispatchMessage (&msg);
/*
把当前的消息发送到窗口消息处理函数中去处理，在这里为WndProc。
当DispatchMessage调用结束后，循环再次重复，重新回到GetMessage处，接着获取消息。
如果消息循环接收到WM_QUIT消息则跳出消息循环。
*/
}
//----------------------------------------------------------------------------------------
return msg.wParam;//返回消息结构中的wParam成员信息。
/*
MSG结构的wParam成员的值是传递给PostQuitMessage函数参数，通常是0。
因为PostQuitMessage函数是在结束消息循环必须调用的函数。
系统其实是执行了return 0;结束了WinMain函数退出了程序,很想控制台应用程序main结束的时候的return 0;，所以直接写return 0;也不会导致程序错误。
*/
}

LRESULT CALLBACK WndProc (HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)//窗口消息处理函数
/*
函数返回类型为LRESULT，是一个长整数，修饰CALLBACK表示此函数为回调函数，函数的返回类型，和参数顺序都必须按照系统的规定设置。
参数一为窗口句柄，第二个参数是无符号整型数据，用于标识接受的消息，最后两个参数为32位的消息参数，提供了更多关于消息的信息。
WPARAM和LPARAM都表示的是长整数，该函数的四个参数与MSG结构的前四个成员相同。
消息处理函数，通常是windows自己调用的，当然程序作者也可以通过调用SendMessage函数直接呼叫自己的窗口消息处理函数，只是在这里暂时不讨论。
*/
{
HDC hdc;//创建设备描述句柄对象
PAINTSTRUCT ps;//创建绘制结构对象
/*
PAINTSTRUCT结构包含了一些窗口消息处理程序，可以用来更新窗口显示区域中的信息。
结构如下：
typedef struct tagPAINTSTRUCT {
HDC hdc;
BOOL fErase;
RECT rcPaint;
BOOL fRestore;
BOOL fIncUpdate;
BYTE rgbReserved[32];
} PAINTSTRUCT, *PPAINTSTRUCT;
*/
RECT rect;//创建矩形结构对象
/*
此结构的定义如下：
typedef struct _RECT {
LONG left;
LONG top;
LONG right;
LONG bottom;
} RECT, *PRECT;
*/
switch (message)//通过switch和case结构来确定处理什么样的消息，如果不想处理某些消息则把消息传递给DefWindowProc函数处理。
{
case WM_CREATE://当窗口创建的时候获得WM_CREATE消息
PlaySound (TEXT("C:\\online.wav"),NULL,SND_FILENAME|SND_ASYNC);//播放声音
return 0;//窗口消息处理函数如果正在处理消息必须返回0
case WM_PAINT://通知窗口更新显示区域的信息
/*
当窗口刚开始建立的时候，整个显示区域都是无效的，因为程序还没有在窗口上绘制任何东西。
第一条WM_PAINT消息通常发生在调用UpdateWindows函数的时候，告诉窗口消息处理函数在显示区域绘制一些东西。
事实上当用户把wndclass.style设置成CS_HREDRAW | CS_VREDRAW后，一旦用户改变窗口大小，就会把显示区域当作无效，这时候就会收到WM_PAINT消息。
*/
/*
通常在处理WM_PAINT消息的时候，总是以BeginPaint开头和EndPaint结尾的。
*/
hdc = BeginPaint (hwnd, &ps);
/*
调用BeginPaint函数可以传回设备句柄，这里指的是显示器的代号和显示器的驱动程序。
因为在窗口显示区域要显示文字或者图形都需要用到设备句柄。
它的函数原形为：
HDC BeginPaint(
HWND hwnd, // handle to window
LPPAINTSTRUCT lpPaint // paint information
);
它实际的功能是：当发现窗口显示区域的背景还没有被清除的时候，则由windows来删除它。
我们前面在wndclass结构中设置了画刷为白色，这么以来系统就用白色来遮盖桌面的颜色，这样窗口显示区域就变成白色了。
*/
GetClientRect (hwnd,&rect);//设置窗口显示区域的尺寸，同时它也负责获得窗口改变后的窗口显示区域的尺寸信息。
DrawText (hdc,TEXT("中国软件开发实验室,http://www.cndev-lab.com"),-1,&rect,DT_SINGLELINE|DT_CENTER|DT_VCENTER);//绘制文字在窗口显示区域中
/*
DT_SINGLELINE|DT_CENTER|DT_VCENTER　表示的是文字显示的方式，这些在WinUser.h头文件中定义。
*/
EndPaint (hwnd,&ps);//结束指定窗口的绘图
return 0;
case WM_DESTROY://当窗口销毁的时候会返回此信息，比如ALT+F4或关闭窗口的时候，系统默认调用DestroyWindow()函数撤消窗口。
PostQuitMessage (0);
/*
处理WM_DESTROY消息必须调用PostQuitMessage函数，该函数向消息队列中发送WM_QUIT消息，让程序退出消息循环。
应用程序可以在响应这个消息的同时做一些其它结束的工作。
*/
return 0;
}
return DefWindowProc (hwnd, message, wParam, lParam);//处理不于处理的消息
}