第一个真正的Windows程序

编写Windows程序，首先要包含 windows.h 头文件。windows.h 还包含了其他一些Windows头文件，例如：

• windef.h：基本类型定义
• winbase.h：内核函数
• wingdi.h：用户接口函数
• winuser.h： 图形设备接口函数

这些头文件定义了Windows的所有数据类型、函数原型、数据结构和符号常量，也就是说，所有的Windows API都在这些头文件中声明。

在C语言中，程序都是“黑屏”的，称为控制台程序(Console Application)。这套教程要讲的是带界面的Windows程序(Windows Application)，也称为GUI程序(GUI Application)。

控制台程序以 main() 为入口函数，Windows程序以 WinMain() 为入口函数，动态链接库(DLL)以 DllMain() 为入口函数（请查看 动态链接库DLL教程），不同的入口函数决定了不同类型的程序。

WinMain() 函数的原型为：

int WINAPI WinMain(
    HINSTANCE hInstance,  // 当前窗口句柄
    HINSTANCE hPrevInstance,  // 前一个窗口句柄，Win32下为NULL（Win16留下的废物，目前已弃用）
    LPSTR lpCmdLine,  // 命令行参数
    int nCmdShow  // 窗口显示方式
);

先不要急于理解这些参数的含义，我先给大家写一个简单的不带黑屏的、真正的Windows程序：

#include <windows.h>
int WINAPI WinMain(
    HINSTANCE hInstance,
    HINSTANCE hPrevInstance,
    LPSTR lpCmdLine,
    int nCmdShow
){
    // 调用API 函数MessageBox
    int nSelect = MessageBox(NULL, TEXT("你好，欢迎来到城东书院！"), TEXT("Welcome"), MB_OKCANCEL);
    if(nSelect == IDOK){
        MessageBox(NULL, TEXT("你点击了“确定”按钮"), TEXT("提示"), MB_OK);
    }else{
        MessageBox(NULL, TEXT("你点击了“取消”按钮"), TEXT("提示"), MB_OK);
    }
    return 0;
}

编译并运行，会弹出一个对话框，如下所示：

点击“确定”或“取消”按钮，又会弹出一个新的提示框。大家可以亲自运行一下，会有真实的体验。原来没有main()函数，没有#include <stdio.h>的C语言程序也是可以运行的！

MessageBox() 函数是众多API中的一个，用于弹出一个指定风格的对话框，其原型为：

WINAPI 为宏定义#define  WINAPI  __stdcall，表示函数调用方式，暂时可以不理会，不影响代码编写，只需要知道MessageBox()返回值为 int，表示按下的按钮。有兴趣的读者可以查看：__stdcall，__cdecl，__pascal，__fastcall的区别

参数说明：

• hWnd：该消息框的父窗口句柄，如果此参数为NULL，则该消息框没有拥有父窗口。大家不用急于理解这个参数，后续会详细讲解。
• lpText：消息框的内容。LPCTSTR 是自定义数据类型，等价于 const char *。
• lpCaption：消息框的标题。
• uType：对话框的按钮样式和图标。

uType 支持的按钮样式：

这些按钮都是宏定义：

#define MB_OK                 0x00000000L
#define MB_OKCANCEL           0x00000001L
#define MB_ABORTRETRYIGNORE   0x00000002L
#define MB_YESNOCANCEL        0x00000003L
#define MB_YESNO              0x00000004L
#define MB_RETRYCANCEL        0x00000005L

你也可以尝试用数字来表示按钮，例如：

也会生成与上面相同的对话框。

除了按钮，uType 还支持图标（图标对用户有提醒作用）：

图标	含义
MB_ICONEXCLAMATION	一个惊叹号出现在消息框：
MB_ICONWARNING	一个惊叹号出现在消息框（同上）
MB_ICONINFORMATION	一个圆圈中小写字母i组成的图标出现在消息框：
MB_ICONASTERISK	一个圆圈中小写字母i组成的图标出现在消息框（同上）
MB_ICONQUESTION	一个问题标记图标出现在消息框：
MB_ICONSTOP	一个停止消息图标出现在消息框：
MB_ICONERROR	一个停止消息图标出现在消息框（同上）
MB_ICONHAND	一个停止消息图标出现在消息框（同上）

这些图标也都是宏定义：

#define MB_ICONHAND           0x00000010L
#define MB_ICONQUESTION       0x00000020L
#define MB_ICONEXCLAMATION    0x00000030L
#define MB_ICONASTERISK       0x00000040L

如果希望同时定义按钮和图标的样式，可以使用或运算|，例如：

MessageBox(
    NULL,
    TEXT("你好，欢迎来到城东书院！"),
    TEXT("Welcome"),
    MB_OKCANCEL | MB_ICONINFORMATION
);

会弹出如下的对话框：

与上面的对话框相比，多出了一个图标，同时还能听到提示音（Win7 有，XP 和 Win8 win10读者可以亲自测试）。

大家有没有发现，按钮都是用十六进制的第1位（二进制前4位）来表示，图标都是使用十六进制第2位（二进制第5~8位）来表示，进行或运算，每个位都不会改变，如下图所示：

Windows 通过检测第1位的值来确定按钮的样式，检测第2位的值来确定图标样式。

再看来一下MessageBox() 的返回值。

MessageBox() 返回被按下的按钮，以数字表示，这些数字都被定义成了宏，如下所示：

对应的宏定义为：

#define IDOK       1
#define IDCANCEL   2
#define IDABORT    3
#define IDRETRY    4
#define IDIGNORE   5
#define IDYES      6
#define IDNO       7