Модуль 1. Ваша первая программа Windows

  • Статья

В этом модуле мы напишем минимальную Windows классическую программу. Все, что это делает, — это создание и отображение пустого окна. Первая программа содержит около 50 строк кода, не считая пустых строк и комментариев. Это будет наша отправная точка; позже мы добавим графику, текст, ввод данных пользователем и другие функции.

Если вы ищете дополнительные сведения о создании традиционного классического приложения Windows в Visual Studio, см. пошаговое руководство. Создание традиционного классического приложения Windows (C++).

Screenshot of the example program, which shows it is a blank window with the title Learn to Program Windows.

Ниже приведен полный код программы:

#ifndef UNICODE
#define UNICODE
#endif 

#include <windows.h>

LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam);

int WINAPI wWinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, PWSTR pCmdLine, int nCmdShow)
{
    // Register the window class.
    const wchar_t CLASS_NAME[]  = L"Sample Window Class";
    
    WNDCLASS wc = { };

    wc.lpfnWndProc   = WindowProc;
    wc.hInstance     = hInstance;
    wc.lpszClassName = CLASS_NAME;

    RegisterClass(&wc);

    // Create the window.

    HWND hwnd = CreateWindowEx(
        0,                              // Optional window styles.
        CLASS_NAME,                     // Window class
        L"Learn to Program Windows",    // Window text
        WS_OVERLAPPEDWINDOW,            // Window style

        // Size and position
        CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT,

        NULL,       // Parent window    
        NULL,       // Menu
        hInstance,  // Instance handle
        NULL        // Additional application data
        );

    if (hwnd == NULL)
    {
        return 0;
    }

    ShowWindow(hwnd, nCmdShow);

    // Run the message loop.

    MSG msg = { };
    while (GetMessage(&msg, NULL, 0, 0) > 0)
    {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }

    return 0;
}

LRESULT CALLBACK WindowProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
    switch (uMsg)
    {
    case WM_DESTROY:
        PostQuitMessage(0);
        return 0;

    case WM_PAINT:
        {
            PAINTSTRUCT ps;
            HDC hdc = BeginPaint(hwnd, &ps);

            // All painting occurs here, between BeginPaint and EndPaint.

            FillRect(hdc, &ps.rcPaint, (HBRUSH) (COLOR_WINDOW+1));

            EndPaint(hwnd, &ps);
        }
        return 0;

    }
    return DefWindowProc(hwnd, uMsg, wParam, lParam);
}

Полный проект Visual Studio можно скачать из Windows Hello World Sample.

Это может быть полезно, чтобы дать краткое описание того, что делает этот код. В последующих разделах подробно рассматривается код.

  1. wWinMain — это точка входа программы. При запуске программы регистрируется некоторая информация о поведении окна приложения. Одним из наиболее важных элементов является адрес функции, именуемой WindowProc в этом примере. Эта функция определяет поведение окна — его внешний вид, взаимодействие с пользователем и т. д.
  2. Затем программа создает окно и получает дескриптор, который однозначно идентифицирует окно.
  3. Если окно создано успешно, программа переходит в цикл while . Программа остается в этом цикле, пока пользователь не закроет окно и не выйдет из приложения.

Обратите внимание, что программа явно не вызывает функцию WindowProc , даже если мы сказали, что это место, где определена большая часть логики приложения. Windows обменивается данными с программой, передавая ему ряд сообщений. Код внутри цикла while управляет этим процессом. Каждый раз, когда программа вызывает функцию DispatchMessage, она косвенно вызывает Windows вызывать функцию WindowProc один раз для каждого сообщения.

В этом разделе

Сведения о программе для Windows в C++

Пример Windows Hello World