Compartilhar via


Módulo 1. Seu primeiro programa do Windows

Neste módulo, escreveremos um programa mínimo da área de trabalho do Windows. Tudo o que ele faz é criar e mostrar uma janela em branco. Este primeiro programa contém cerca de 50 linhas de código, sem contar linhas e comentários em branco. Será nosso ponto de partida; posteriormente, adicionaremos elementos gráficos, texto, entrada do usuário e outros recursos.

Se você estiver procurando mais detalhes sobre como criar um aplicativo de área de trabalho tradicional do Windows no Visual Studio, marcar passo a passo: criar um aplicativo tradicional da Área de Trabalho do Windows (C++).

Captura de tela do programa de exemplo, que mostra que ele é uma janela em branco com o título Aprender a Programar Windows.

Este é o código completo para o programa:

#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);
}

Você pode baixar o projeto completo do Visual Studio de Windows Hello Exemplo Mundial.

Pode ser útil dar uma breve estrutura de tópicos sobre o que esse código faz. Tópicos posteriores examinarão o código em detalhes.

  1. wWinMain é o ponto de entrada do programa. Quando o programa é iniciado, ele registra algumas informações sobre o comportamento da janela do aplicativo. Um dos itens mais importantes é o endereço de uma função, nomeada WindowProc neste exemplo. Essa função define o comportamento da janela — sua aparência, como ela interage com o usuário e assim por diante.
  2. Em seguida, o programa cria a janela e recebe um identificador que identifica exclusivamente a janela.
  3. Se a janela for criada com êxito, o programa inserirá um loop while . O programa permanece nesse loop até que o usuário feche a janela e saia do aplicativo.

Observe que o programa não chama explicitamente a WindowProc função, embora tenhamos dito que é aqui que a maior parte da lógica do aplicativo é definida. O Windows se comunica com seu programa passando-lhe uma série de mensagens. O código dentro do loop while conduz esse processo. Sempre que o programa chama a função DispatchMessage , ele indiretamente faz com que o Windows invoque a função WindowProc, uma vez para cada mensagem.

Nesta seção

Saiba como Programar para Windows no C++

Amostra do Windows Hello World