/*
纯C通过 Windows API 编写的基本 Windows 图形界面
整理加原创，基本上每一句代码都有注释
通过 C-Free 3.5编译
*/

#include <string.h>         //这个头文件在扩展名为.c时是不需要加的
#include <windows.h>        //windows api必须包含的头文件

LRESULT CALLBACK WndProc(HWND,UINT,WPARAM,LPARAM);      //窗口函数的前向声明

//参数说明：
//HINSTANCE hInstance   当前实例句柄
//HINSTANCE hPrevInstance   以前版本的遗留产物，现在总是置为 NULL
//LPSTR lpCmdLine       命令行的产生，可以从开始->获得程序运行的参数，由此传入
//int nCmdShow      程序最初的显示模式，正常，最大化或最小化

//主函数的入口是WinMain, 类型为int
//WINAPI标志是一种特定的调用, 它定义了一种生成机器代码和放置函数参数的方式

int WINAPI WinMain(HINSTANCE hInstance,HINSTANCE hPrevInstance,LPSTR lpcmdLine,int nCmdShow)
{
    //TCHAR, TEXT都是统一单字节和双字节字符的类型, 建议使用
    static TCHAR szAppName[] = TEXT("MyFirstWindows");
    static TCHAR szClassName[] = TEXT("MFWClass");
    HWND hwnd;       //一定一个窗口句柄
    MSG msg;        //定义一个消息结构体
    WNDCLASS wndclass;      //定义一个 WNDCLASS 结构用于注册窗口
    
    wndclass.style = CS_HREDRAW | CS_VREDRAW;       //窗口类的类风格，每当水平和垂直大小改变时完全刷新窗口
    wndclass.lpfnWndProc = WndProc;     //此窗口类所使用的窗口函数的入口地址
    wndclass.cbClsExtra = 0;        //用于在类结构中预留一些额外的空间
    wndclass.cbWndExtra = 0;        //用于在windows内部保存的窗口结构中预留一些额外的空间
    wndclass.hInstance = hInstance;     //指定所在程序的实例句柄
    wndclass.hIcon = LoadIcon(NULL,IDI_APPLICATION);        //定制图标
    wndclass.hCursor = LoadCursor(NULL,IDC_ARROW);      //定制鼠标图形
    wndclass.hbrBackground = (HBRUSH)GetStockObject(GRAY_BRUSH);        //定义背景颜色
    wndclass.lpszMenuName = NULL;       //指定窗口类的菜单
    wndclass.lpszClassName =szClassName;        //指定窗口类的类名


//注册窗口，参数为指向 WNDCLASS 结构的指针
//如果注册不成功，则弹出一个对话框说明情况
//MessageBox是仅有的可以在旧版本和新版本windows都可以运行的对话框

    if(!RegisterClass(&wndclass))
    {
        MessageBox(NULL,TEXT("This program requires Windows NT or above!"),szAppName,MB_ICONERROR);
        return 0;
    }

//创建窗口
    hwnd = CreateWindow(
                        szClassName,        //窗口类的名称
                        TEXT("Title:My First Windows Program. 这里是标题"),     //窗口标题
                        //WS_OVERLAPPEDWINDOW,   //窗口显示风格，这行实际是一个预定义，相当于下面的集合，可以单独设置
                        WS_OVERLAPPED | WS_CAPTION | WS_SYSMENU | WS_THICKFRAME | WS_MINIMIZEBOX | WS_MAXIMIZEBOX,
                        CW_USEDEFAULT,      //初始 x 方向的位置
                        CW_USEDEFAULT,      //初始 y 方向的位置
                        CW_USEDEFAULT,      //初始 x 方向的大小
                        CW_USEDEFAULT,      //初始 y 方向的大小
                        NULL,       //父窗口句柄
                        NULL,       //菜单句柄
                        hInstance,      //程序实例句柄
                        NULL    );      //创建参数


//显示窗口，第一个参数 hwnd 是 CreateWindow 所创建的窗口的句柄
//第二个参数 nCmdShow 是主函数给的，由快捷方式获得
    ShowWindow(hwnd,nCmdShow);

//刷新窗口，给窗口函数，在本程序中即 WndProc 发送一个 WM_PAINT
    UpdateWindow(hwnd);

//消息循环
    while(GetMessage(&msg,NULL,0,0))        //接受自己创建的所有窗口的所有消息
    {
        TranslateMessage(&msg);     //将 msg 结构体传给windows以进行一些键盘转换, 即将击键消息转换为字符消息
        DispatchMessage(&msg);      //再次将 msg 结构体传给windows，由windows将该消息发送给适当的窗口函数
    }

    return (int)msg.wParam;
}

//窗口函数
//参数说明:
//HWND hwnd, 接受消息的窗口句柄，由CreateWindow函数返回
//UINT message, 消息标志符，用以标识消息，每个消息均有一个唯一对应的消息标识符
//WPARAM wParam, 是 WORD PARAM 的意思，一个32位的消息参数，其含义和数值根据消息的不同而不同
//LPARAM lParam, 是 LONG PARAM 的意思，一个32位的消息参数，其值和消息有关

//CALLBACK函数指由程序员定义，编程实现，而由windows系统调用的函数
LRESULT CALLBACK WndProc(HWND hwnd,UINT message,WPARAM wParam,LPARAM lParam)
{
    HDC hdc;        //定义一个设备描述表句柄结构体

    //定义一个 PAINTSTRUCT 的绘制信息结构体，
    //其包含了包含了当前无效矩形区域的坐标和其他信息，用于刷新用户区的内容
    PAINTSTRUCT ps;

    RECT rect;      //定义一个 RECT 结构体，其有left,top,right,bottom 四个域
    
    //处理传进的各种消息
    switch(message)
    {
        //窗口创建
        case WM_CREATE: MessageBox(NULL,"MessageContent : This is WM_CREATE，这是 WM_CREATE。",
                            "MessageTiTle 这是对话框的标题",MB_OK);
                        return 0;
        
        //窗口绘制
        case WM_PAINT:  hdc = BeginPaint(hwnd,&ps);     //由BeginPaint开始，返回设备描述表以开始绘图
                        GetClientRect(hwnd,&rect);      //获取用户区域的大小

                        //格式话文本输出
                        DrawText(hdc,TEXT("WindowsContent : I am a developer. 我为计算机而生。"),
                            -1,&rect,DT_SINGLELINE | DT_CENTER | DT_VCENTER);
                        EndPaint(hwnd,&ps);     //以EndPaint结束，释放设备描述表句柄
                        return 0;
        //窗口消亡
        case WM_DESTROY: MessageBox(NULL,"MessageContent : This is WM_DESTROY，这是 WM_DESTROY。",
                            "MessageTiTle 这是对话框的标题",MB_OK);
                         PostQuitMessage(0);
                         return 0;
    }
    
    //凡是窗口函数不予处理的消息应交由windows默认消息处理函数DefWindowProc处理
    return DefWindowProc(hwnd,message,wParam,lParam);
}