Hello Win

  1 /*
  2     HELLOWIN.C -- Displays "Hello, Windows 98!" in client area
  3     (c) Louis Lu, 2008
  4 */
  5 
  6 #include <windows.h>
  7 
  8 LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM);
  9 
 10 // 程序入口函数，主函数
 11 // HINSTANCE 执行实体（程序自身）句柄
 12 int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, PSTR szCmdLine, int iCmdShow)
 13 {
 14     static TCHAR szAppName[] = TEXT("HelloWin");
 15     HWND hwnd; //窗口句柄
 16     MSG msg; //消息结构
 17     WNDCLASS wndclass; //窗口类别结构
 18 
 19     wndclass.style = CS_HREDRAW | CS_VREDRAW; //窗口类别样式
 20     wndclass.lpfnWndProc = WndProc; //窗口类别的消息处理程序
 21     wndclass.cbClsExtra = 0; //窗口类别结构预留额外空间
 22     wndclass.cbWndExtra = 0; //窗口结构中预留额外空间
 23     wndclass.hInstance = hInstance; //程序的执行实体句柄（WinMain的参数之一）
 24     // LoadIcon 加载图标供程序使用
 25     wndclass.hIcon = LoadIcon(NULL, IDI_APPLICATION);  //图标(显示在窗口标题列的左端)
 26     // LoadCursor 加载鼠标光标供程序使用
 27     wndclass.hCursor = LoadCursor(NULL, IDC_ARROW); //鼠标光标
 28     // GetStockObject 取得一个图形对象
 29     wndclass.hbrBackground = (HBRUSH)GetStockObject(WHITE_BRUSH); //设置窗口背景颜色
 30     wndclass.lpszMenuName = NULL; //指定窗口类别菜单，NULL表示没有应用程序菜单
 31     wndclass.lpszClassName = szAppName; //必须给出一个类别名称，对于小程序，类别名称可以与程序名相同
 32 
 33     if (!RegisterClass(&wndclass)) //为程序窗口注册窗口类别
 34     {
 35         MessageBox(NULL, TEXT("This program requires Windows NT!"), szAppName, MB_ICONERROR);
 36 
 37         return 0;
 38     }
 39 
 40     //根据窗口类别建立一个窗口
 41     hwnd = CreateWindow(szAppName, // window class name
 42         TEXT("The Hello Program"), // window caption
 43         WS_OVERLAPPEDWINDOW, // window style
 44         CW_USEDEFAULT, // initial x position
 45         CW_USEDEFAULT, // initial y position
 46         CW_USEDEFAULT, // initial x size
 47         CW_USEDEFAULT, // initial y size
 48         NULL, // parent window handle
 49         NULL, // window menu handle
 50         hInstance, // program instance handle
 51         NULL); // creation parameters
 52 
 53     //在屏幕上显示窗口
 54     ShowWindow(hwnd, iCmdShow); // hwnd，窗口句柄；iCmdShow，确定如何在屏幕上显示窗口，是一般大小，最小化还是最大化。
 55     //指示窗口自我更新
 56     UpdateWindow(hwnd);  //重绘显示区域，它经由发送给窗口消息处理程序一个WM_PAINT做到这一点。
 57 
 58 
 59     // Windows为当前执行的每个Windows程序维护一个‘消息队列’。在发生输入事件之后，
 60     // Windows将事件转换为一个‘消息’，并将消息放入程序的消息队列中。
 61     // 程序通过执行一块称之为‘消息循环’的程序代码从消息队列中取出消息。
 62     while(GetMessage(&msg, NULL, 0, 0)) //从消息队列中取得消息
 63     {
 64         TranslateMessage(&msg); // 将msg结构传给Windows，进行一些键盘转换。
 65         DispatchMessage(&msg); // 又将msg结构传给Windows,然后，Windows将该消息发送给适当的窗口消息处理程序，让它进行处理。也就是说，Windows将呼叫窗口消息处理程序。
 66     }
 67 
 68     //wParam是传递给PostQuitMessage函数的值（通常是0）。
 69     return msg.wParam;
 70 }
 71 
 72 
 73 // 窗口消息处理函数
 74 LRESULT CALLBACK WndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)
 75 {
 76     HDC hdc; //设备内容句柄
 77     PAINTSTRUCT ps; //绘图信息结构，Windows为每个设备保存一个。
 78     RECT rect; //矩形结构
 79 
 80     switch(message)
 81     {
 82     case WM_CREATE:
 83         PlaySound(TEXT("hellowin.wav"), NULL, SND_FILENAME|SND_ASYNC); //播放一个声音文件
 84         return 0;
 85 
 86     case WM_PAINT:
 87         //取得设备内容句柄
 88         hdc = BeginPaint(hwnd, &ps); //开始绘制窗口
 89         GetClientRect(hwnd, &rect); //取得窗口显示区域的大小
 90         //hdc:BeginPaint传出来的设备内容句柄
 91         //TEXT(''):要输出的文字
 92         //-1:指示字符串是以字节0终结的
 93         //最后一个参数：旗标，控制文字显示的位置。
 94         DrawText(hdc, TEXT("Hello, Windows 98!"), -1, &rect, DT_SINGLELINE | DT_CENTER | DT_VCENTER); //显示字符串
 95         //释放设备内容句柄
 96         EndPaint(hwnd, &ps); //结束绘制窗口
 97         return 0;
 98 
 99     case WM_DESTROY: //关闭窗口，该消息是使用者单击Close按钮或者在程序的系统菜单上选择Close时发生的。
         PostQuitMessage(0); //在消息队列中插入一个[退出程序]/WM_QUIT消息，当GetMessage得到一个WM_QUIT消息时，它传回0，这将导致WinMain退出消息循环，并终止程序。
         return 0;
     }
 
     //执行内定的消息处理
     return DefWindowProc(hwnd, message, wParam, lParam);
 }