VC++入门程序详解

#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.xxx.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);
//处理不于处理的消息
}