win32桌面应用程序开发入门——初始代码解读

win32新建项目的详细代码注释

头文件及变量定义部分

//WindowsProject1.cpp: 定义应用程序的入口点。
//

#include "stdafx.h"
#include "WindowsProject1.h"

#define MAX_LOADSTRING 100

// 全局变量: 

//HINSTANCE 是Windows里的一中数据类型，是用于标示（记录）一个程序的实例。
//它与HMODULE是一样的（通用的，这两种类型最终就是32位无符号长整形）。
//HINSTANCE，分开看就是 HANDLE(句柄) + INSTANCE（实例）
//实例就是一个程序。用qq来举例：你可以开同时开2个qq号，但是你电脑里的qq软件只有一份。
//这2个qq号就是qq的2个实例
HINSTANCE hInst;                                // 当前实例x
WCHAR szTitle[MAX_LOADSTRING] = _T("Welcome to PL0DE");                  // 标题栏文本
WCHAR szWindowClass[MAX_LOADSTRING] = _T("PL0DE");            // 主窗口类名

// 此代码模块中包含的函数的前向声明
ATOM                MyRegisterClass(HINSTANCE hInstance);
BOOL                InitInstance(HINSTANCE, int);
// 如果应用程序的对话框中有“确定”按钮，那么用户单击该按钮时，
// 操作系统会向应用程序发送一条消息，通知按钮已被单击。WndProc 负责对该事件作出响应。
LRESULT CALLBACK    WndProc(HWND, UINT, WPARAM, LPARAM);
INT_PTR CALLBACK    About(HWND, UINT, WPARAM, LPARAM);
INT_PTR CALLBACK    Contact(HWND, UINT, WPARAM, LPARAM);

程序入口部分

// 正如每个 C/C++控制台应用程序在起始点必须具有 main 函数，每个基于 Win32 的应用程序的函数\
也必须具有 WinMain 函数。WinMain就相当于是入口函数，并且具有固定的语法
int APIENTRY wWinMain(_In_ HINSTANCE hInstance,
                     _In_opt_ HINSTANCE hPrevInstance,
                     _In_ LPWSTR    lpCmdLine,
                     _In_ int       nCmdShow)
{
	// 现在编译器在编译你的引用 hPrevInstance 的函数时便会住口,不会提示说没有使用此变量
	// 那我们不使用为什么还需要呢，通常是因为 我们实现某个函数以满足某些API固有的署名需要
	// 在这里就是使用了WINAPI，所以必须有这个变量的声明
    UNREFERENCED_PARAMETER(hPrevInstance);
    UNREFERENCED_PARAMETER(lpCmdLine);

    // TODO: 在此放置代码。

    // 初始化全局字符串
    LoadStringW(hInstance, IDS_APP_TITLE, szTitle, MAX_LOADSTRING);
    LoadStringW(hInstance, IDC_WINDOWSPROJECT1, szWindowClass, MAX_LOADSTRING);
    // 创建+注册窗口类
	if (!MyRegisterClass(hInstance)) {
		MessageBox(NULL, _T("Call to RegisterClassEx failed!"), _T("Win32 Guided Tour"), NULL);
		return 1;
	}

    // 执行应用程序初始化: 
    if (!InitInstance (hInstance, nCmdShow))
    {
        return FALSE;
    }

	// LoadAccelerators是用来加载快捷键表的
    HACCEL hAccelTable = LoadAccelerators(hInstance, MAKEINTRESOURCE(IDC_WINDOWSPROJECT1));

    MSG msg;
    // 主消息循环: 
	// 添加用于侦听操作系统所发送消息的消息循环。 
	// 当应用程序收到一条消息时，此循环将该消息调度到 WndProc 函数以进行处理。
    while (GetMessage(&msg, nullptr, 0, 0))
    {
        if (!TranslateAccelerator(msg.hwnd, hAccelTable, &msg))
        {
            TranslateMessage(&msg);//翻译消息
            DispatchMessage(&msg);//派遣消息
        }
    }

    return (int) msg.wParam;
}

窗口注册部分

//
//  函数: MyRegisterClass()
//
//  目的: 注册窗口类。
//
ATOM MyRegisterClass(HINSTANCE hInstance)
{

	//创建 WNDCLASSEX 类型的窗口类结构。 此结构包含关于窗口的信息
	//例如应用程序图标、窗口背景色、标题栏中显示的名称、窗口过程函数的名称等
    WNDCLASSEXW wcex;

    wcex.cbSize = sizeof(WNDCLASSEX);

    wcex.style          = CS_HREDRAW | CS_VREDRAW;
    wcex.lpfnWndProc    = WndProc;
    wcex.cbClsExtra     = 0;
    wcex.cbWndExtra     = 0;
    wcex.hInstance      = hInstance;
    wcex.hIcon          = LoadIcon(hInstance, MAKEINTRESOURCE(IDI_WINDOWSPROJECT1));
    wcex.hCursor        = LoadCursor(nullptr, IDC_ARROW);
    wcex.hbrBackground  = (HBRUSH)(COLOR_WINDOW+1);
    wcex.lpszMenuName   = MAKEINTRESOURCEW(IDC_WINDOWSPROJECT1);
    wcex.lpszClassName  = szWindowClass;
    wcex.hIconSm        = LoadIcon(wcex.hInstance, MAKEINTRESOURCE(IDI_SMALL));

	// 现在已创建了窗口类，必须进行注册
	// 使用RegisterClassEx 函数，并将窗口类结构作为参数传递
    return RegisterClassExW(&wcex);
}

初始化/实例化部分

//
//   函数: InitInstance(HINSTANCE, int)
//
//   目的: 保存实例句柄并创建主窗口
//
//   注释: 
//
//        在此函数中，我们在全局变量中保存实例句柄并
//        创建和显示主程序窗口。
//
BOOL InitInstance(HINSTANCE hInstance, int nCmdShow)
{
   hInst = hInstance; // 将实例句柄存储在全局变量中

   //  现在需要使用CreateWindow函数创建窗口
   // szWindowClass主窗口类名，szTitle是title名字
   // WS_OVERLAPPEDWINDOW：the type of window to create
   // CW_USEDEFAULT: initial position (x, y)
   // 0：initial size (width, length)
   // first nullptr：the parent of this window 
   // second nullptr：this application does not have a menu bar
   // hInstance: the first parameter from WinMain 
   // nullptr: not used in this application
   HWND hWnd = CreateWindowW(szWindowClass, szTitle, WS_OVERLAPPEDWINDOW,
      CW_USEDEFAULT, 0, CW_USEDEFAULT, 0, nullptr, nullptr, hInstance, nullptr);

   if (!hWnd)
   {
	   MessageBox(NULL, _T("Call to CreateWindow failed!"), _T("Win32 Guided Tour"), NULL);
      return FALSE;
   }

   // 使用ShowWindow函数显示窗口
   // hWnd: CreateWindow函数返回的窗口句柄 
   // nCmdShow: the fourth parameter from WinMain 
   ShowWindow(hWnd, nCmdShow);

   // UpdateWindow函数用于更新窗口指定的区域
   // 如果窗口更新的区域不为空，UpdateWindow函数就发送一个WM_PAINT消息来更新指定窗口的客户区。
   // 函数绕过应用程序的消息队列，直接发送 WM_PAINT 消息给指定窗口的窗口过程
   // 如果更新区域为空，则不发送消息
   UpdateWindow(hWnd);

   return TRUE;
}

消息处理部分

//
//  函数: WndProc(HWND, UINT, WPARAM, LPARAM)
//
//  目的:    处理主窗口的消息。
//
//  WM_COMMAND  - 处理应用程序菜单
//  WM_PAINT    - 绘制主窗口
//  WM_DESTROY  - 发送退出消息并返回
//
//
LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
{
	// WndProc 函数用以处理应用程序收到的消息
    switch (message)
    {
    case WM_COMMAND:
        {
            int wmId = LOWORD(wParam);
            // 分析菜单选择: 
            switch (wmId)
            {
            case IDM_ABOUT:
                DialogBox(hInst, MAKEINTRESOURCE(IDD_ABOUTBOX), hWnd, About);
                break;
            case IDM_EXIT:
                DestroyWindow(hWnd);
                break;
			case IDM_CONTACT:
				DialogBox(hInst, MAKEINTRESOURCE(IDD_CONTACTBOX), hWnd, Contact);
				break;
            default:
                return DefWindowProc(hWnd, message, wParam, lParam);
            }
        }
        break;
	// WM_PAINT 代表收到了绘图消息
    case WM_PAINT:
		//  WM_PAINT消息代表绘制主窗体
        {
            PAINTSTRUCT ps;
			// 要处理 WM_PAINT 消息，首先应调用 BeginPaint
            HDC hdc = BeginPaint(hWnd, &ps);

			// -----------------在这段代码对应用程序进行布局------------------------
            // TODO: 在此处添加使用 hdc 的任何绘图代码...
			TCHAR greeting[] = _T("Hello, World!");
			TextOut(hdc, 50, 5, greeting, _tcslen(greeting)); // TextOut 函数用于显示字符串
			// FillRect(hdc, &ps.rcPaint, (HBRUSH)(COLOR_WINDOW + 1));
            // -----------------------布局模块结束--------------------------------

			EndPaint(hWnd, &ps);
        }
        break;
    case WM_DESTROY:
		//  WM_DESTROY消息代表投递一个退出消息并返回 
        PostQuitMessage(0);
        break;
    default:
		//DefWindowProc缺省窗口处理函数
		//这个函数是默认的窗口处理函数，我们可以把不关心的消息都丢给它来处理
        return DefWindowProc(hWnd, message, wParam, lParam);
    }
    return 0;
}

消息处理调用函数

// “关于”框的消息处理程序。
INT_PTR CALLBACK About(HWND hDlg, UINT message, WPARAM wParam, LPARAM lParam)
{
    UNREFERENCED_PARAMETER(lParam);
    switch (message)
    {
    case WM_INITDIALOG:
        return (INT_PTR)TRUE;

    case WM_COMMAND:
        if (LOWORD(wParam) == IDOK || LOWORD(wParam) == IDCANCEL)
        {
            EndDialog(hDlg, LOWORD(wParam));
            return (INT_PTR)TRUE;
        }
        break;
    }
    return (INT_PTR)FALSE;
}

// “联系”框的消息处理程序。
INT_PTR CALLBACK Contact(HWND hDlg, UINT message, WPARAM wParam, LPARAM lParam)
{
	UNREFERENCED_PARAMETER(lParam);
	switch (message)
	{
	case WM_INITDIALOG:
		return (INT_PTR)TRUE;
	case WM_COMMAND:
		// 这里面是框BOX内的按钮的名字
		if (LOWORD(wParam) == IDOK || LOWORD(wParam) == IDCANCEL)
		{
			EndDialog(hDlg, LOWORD(wParam));
			return (INT_PTR)TRUE;
		}
		break;
	}
	return (INT_PTR)FALSE;
}