/*****************************************************
 Windows SDK编程之一  窗口示例程序
******************************************************/

/*Win32应用程序框架主要由"初始化窗口类"，"窗口注册类"，"窗口的创建"以"窗口消息函数"等组成*/
#include "stdafx.h"

LRESULT CALLBACK WndProc(HWND,UINT,WPARAM,LPARAM);  //窗口函数说明

/*
  WinMain函数是所有windows应用程序的入口，类似于C语言中的Main函数，其功能是完成一系列的定义和初始化工作，并产生消息循环。消息循环是整个程序运行的核心。WinMain函数实现以下功能。
  1. 注册窗口类，建立窗口及执行其它必要的初始化工作；
  2. 进入消息循环，根据从应用程序消息队列接受的消息，调用相应的处理过程
  3. 当消息循环检索到WM_QUIT消息时终止程序运行。

  WinMain函数有三个基本的组成部份：函数说明、初始化和消息循环。

 WinMain函数的说明如下：
 int WINAPI WinMain(  //WinMain函数说明
             HINSTANCE hInstance, //程序当前实例句柄       
             HINSTANCE hPrevInstance,  //应用程序其它实例句柄
             LPSTR     lpCmdLine, //指向程序命令行参数的指针
             int   nCmdShow  //应用程序开始执行时窗口显示方式的整数值标识
)
      由于Window操作系统是多任务的操作系统，能进行多任务的管理，因此，windows应用程序可能被并行的多次执行，因而可能出现同一个程序的多个窗口同时存在的情况，Windows系统将应用程序每一次执行称为该应用程序的一个实例（Instance），并用一个实例句柄唯一的标识它。

*/
int APIENTRY WinMain(HINSTANCE hInstance,           //WinMain函数说明
                     HINSTANCE hPrevInstance,
                     LPSTR     lpCmdLine,
                     int       nCmdShow)
{
  // TODO: Place code here.
 /*
 建议采用Pascal的变量定义风格，即在程序（函数）开始处定义所有变量
 虽然C＋＋的变量定义比较灵活，本程序为了使程序易于理解,未采用这种方法
 */
   
 char lpszClassName[]="窗口";       //窗口类名
 char lpszTitle[]="Windows SDK编程之一  窗口示例程序";   //窗口标题名

 //---------------窗口类定义-------------------------------------
 /*
 窗口类的定义
    在Windows应用程序中，窗口害定义了窗口的形式与功能。窗口类定义通过给窗口类数据结构WNDCLASS赋值完成，该数据结构中包括窗口类的各种属性，在窗口类定义过程中常用到以下函数：
 */
 WNDCLASS wndclass;
 wndclass.style=0;                                              //窗口类型为缺省类型
 wndclass.lpfnWndProc=WndProc;                                  //窗口处理函数为WndProc
 wndclass.cbClsExtra=0;                                         //窗口类无扩展
 wndclass.cbWndExtra=0;                                         //窗口实例无扩展
 wndclass.hInstance=hInstance;                                  //当前实例句柄
 
 wndclass.hIcon=LoadIcon(NULL,IDI_APPLICATION);                 //使用缺省图标
 /*
  LoadIcon（）：在应用程序中加载一个窗口图标
     LoadIcon（）函数原型为：
             HICON LoadIcon（
                   HINSTANCE hInstance,//图标资源所在的模块句柄，为NULL则使用系统预定义图标
                   LPCTSTR lpIconName //图标资源名或系统预定义图标标识名
             )
 */

 wndclass.hCursor=LoadCursor(NULL,IDC_ARROW);                   //窗口采用箭头光标
    /*
 LoadCursor():在应用程序中加载一个窗口光标
    LoadCursor()函数原型为：
             HCURSOR LoadCursor（
                     HINSTANCE hInstance,//光标资源所在的模块句柄，为NULL则使用系统预定义光标
                     LPCTSTR lpCursorName //光标资源名或系统预定义光标标识名
             )
 */

 wndclass.hbrBackground=(HBRUSH)GetStockObject(WHITE_BRUSH);    //窗口背景为白色
 /*
  GetStockObject（）：获取已经定义的画笔、画刷、字体等对象的句柄
     GetStockObject（）函数原型为：
                   HGDIOBJ GetStockObject（int fnObject）; //fnObject为对象的标识名

 */

 wndclass.lpszMenuName=NULL;                                    //窗口中无菜单
 wndclass.lpszClassName=lpszClassName;                          //窗口类名为'窗口实例'

 //------------------以下是进行窗口类的注册---------------------------
 
 /*
    注册窗口类
    Windows系统本身提供部份预定义的窗口类，程序员也可以自定义窗口类，窗口类必须先注册后使用。窗口类的注册由注册函数RegisterClass（）实现。其形式为:
    RegisterClass(&wndclass)
   &wndclass为窗口类结构
      RegisterClass函数的返回值为布尔值,注册成功则返回真
 */
 if (! RegisterClass(&wndclass))     //注册窗口，若失败，则发出声音
 { MessageBeep(0);
   return FALSE;
 }
   
 /*
 创建窗口实例
 创建一个窗口类的实例由函数CreateWindow()实现,该函数的原型为:
    HWND  CreateWindow(LPCTSTR lpszClassName,             //创建窗口，窗口类名
             LPCTSTR lpszTitle,                     //窗口实例的标题名
             DWORD dwStyle,           //窗口的风格
             int x,   //窗口左上角坐标
       int y,   //窗口左上角坐标
             int nWidth,   //窗口的宽度
       int nHeight,   //窗口的高度
               HWND hwndParent,           //此窗口父窗口
             HWENU hMenu,          //此窗口主菜单
                HINSTANCE hInstance, //应用程序当前句柄
             LPVOID lpParam);        //指向一个传递给窗口的参数值的指针
 */
 
 //创建窗口操作
 HWND hwnd; //窗口结构
    hwnd=CreateWindow(lpszClassName,   //创建窗口，窗口类名
  lpszTitle,                     //窗口实例的标题名
  WS_OVERLAPPEDWINDOW,           //窗口的风格
  CW_USEDEFAULT,CW_USEDEFAULT,   //窗口左上角坐标为缺省值
  CW_USEDEFAULT,CW_USEDEFAULT,   //窗口的高度和宽度为缺省值
  NULL,                          //此窗口无父窗口
  NULL,                          //此窗口无主菜单
  hInstance,                     //应用程序当前句柄
  NULL);                         //不使用该值

 ShowWindow(hwnd,nCmdShow);         //显示窗口

 UpdateWindow(hwnd);                //绘制用户区
 

    /*
  消息循环
  windows应用程序的运行以消息为核心。windows将产生的消息放入应用程序的消息队列中而应用程序WinMain函数的消息循环提取消息队列中的消息，并将其传递给窗口函数为相应处理过程处理。
    MSG msg; //消息结构

 while( GetMessage(&msg,NULL,0,0))  //消息循环
 { TranslateMessage(&msg);
   DispatchMessage(&msg);
 }
 */

 MSG msg; //消息结构
  /*GetMessage()作用：从消息队列中读取一条消息，并将消息放在一个MSG结构中：
   BOOL GetMessage(        
        LPMSG lpMsg,  //指向MSG结构的指针
        HWND hWnd,
        UINT wMsgFilterMin, //用于消息过滤的最小信息号值
        UINT wMsgFilterMax //用于消息过滤的最大信息号值 如最小值和最大值均为0， 则不过滤消息
   );
  当GetMessage返回0时，即检索到WM_QUIT消息，程序将结束循环并退出

 BOOL TranslateMessage(  const MSG *lpMsg );  负责把消息的虚拟键值转换为字符信息
 LRESULT DispatchMessage( const MSG *lpmsg  ); 将参数lpmsg指向的消息传递给指定的窗口

  */
 while( GetMessage(&msg,NULL,0,0))  //消息循环
 { TranslateMessage(&msg);
   DispatchMessage(&msg);
 }

 return msg.wParam;                //程序终止时，将信息返回操作系统
}

//-----------------------------窗口函数---------------------------------------
/*
窗口消息处理函数定义了应用程序对接收到的不同消息的响应，它包含了应用程序对各种可用接收到的消息的处理过程，通常　，窗口函数由一个或多个switch...case语句组成，每一条case语句
对应一种消息，当应用程序接收到一个消息时，相应的case语句被　激活并执行相应的响应程序模块。
窗口函数的一般形式如下：
 LRESULT CALLBACK WindowProc(          HWND hwnd,
    UINT uMsg,
    WPARAM wParam,
    LPARAM lParam
);
Parameters

hwnd　：[in] Handle to the window.
uMsg　：[in] Specifies the message.
wParam：[in] Specifies additional message information. The contents of this parameter depend on the value of the uMsg parameter.
lParam：[in] Specifies additional message information. The contents of this parameter depend on the value of the uMsg parameter.
Return Value　
The return value is the result of the message processing and depends on the message sent.

LRESULT CALLBACK WndProc(HWND hwnd,UINT message,WPARAM wParam,LPARAM lParam)
{
  switch (message)
  {
  case ...
      ....
   break;
   .........
  case WM_DESTROY:
     //void PostQuitMessage(int nExitCode)函数的作用是向程序发送WM＿QUIT消息，nExitCode应用程序退出代码
      PostQuitMessage(0); //调用该函数发出WM_QUIT消息
  default: //缺省消息处理函数,以保证所的发往窗口的消息都能被处理
   return DefWindowProc(hwnd,message,wParam,lParam);
  }

  return (0);
}

*/
LRESULT CALLBACK WndProc(HWND hwnd,UINT message,WPARAM wParam,LPARAM lParam)
{
  switch (message)
  {
  case WM_DESTROY:
    PostQuitMessage(0); //调用该函数发出WM_QUIT消息
  default: //缺省消息处理函数
   return DefWindowProc(hwnd,message,wParam,lParam);
  }

  return (0);
}
/*
注：
  事件驱动的特点：
  Windows程序设计围绕着事件或消息的产生驱动产生运行消息处理函数。Windows程序的执行顺序取决于事件发生的顺序，程序的执行是由顺序产生的消息驱动的，程序员可以针对消息类型编写消息处理程序以处理接收的消息，或者发出其他消息以驱动其他处理程序，但是不必预先确定消息的产生顺序。这是面向对象编程中事件驱动的显著特点。
  事件驱动编程方法对于编写交互程序很有用处，用这一方法编写的程序使程序避免了死板的操作模式，从而使用户能够按照自己的意愿采用灵活多变的操作模式。
  Windows应用程序中的消息传递机制：
  VC中存在几种系统定义的消息分类，常用的消息由窗口消息、初始化消息、输入消息、系统消息、剪切板消息、文当界面消息、DDE（动态数据交换）消息、应用程序自定义消息等。应用程序发送的消息发送至消息队列，系统根据消息到达的顺序对消息进行处理，并调用响应的消息处理模块代码。
*/