C++：ShowWindow()函数

1. 功能概述

在C++的Windows编程中，ShowWindow函数用于设置窗口的显示状态。它可以控制窗口是显示、隐藏、最小化、最大化还是以其他指定的方式呈现给用户。这个函数是操作窗口可见性的重要工具，通过它可以根据程序的逻辑和用户的操作来灵活地控制窗口的显示方式。

2. 函数原型及参数解释

BOOL ShowWindow(HWND hWnd, int nCmdShow);

参数说明：

hWnd（HWND类型）：这是要设置显示状态的窗口的句柄。这个句柄是在创建窗口时由CreateWindow或CreateWindowEx函数返回的。例如，在典型的Windows程序中，先使用CreateWindowEx函数创建一个窗口并获取其句柄，然后将这个句柄传递给ShowWindow函数来控制该窗口的显示状态。

nCmdShow（int类型）：这个参数指定了窗口的显示方式。它可以取以下一些常见的值：

SW_SHOWNORMAL：以正常大小和位置显示窗口。如果窗口之前是最小化或最大化状态，会恢复到正常状态。这是比较常用的一个值，用于正常地显示窗口。

SW_SHOWMAXIMIZED：将窗口最大化显示，使其占据整个屏幕（除了任务栏等系统保留区域）或者填满父窗口（如果是子窗口）。

SW_SHOWMINIMIZED：将窗口最小化显示，窗口会缩小成任务栏上的一个图标或者按照系统的最小化规则进行显示。

SW_HIDE：隐藏窗口，使其不可见。这在某些情况下很有用，比如在后台运行的程序窗口或者需要暂时隐藏窗口以进行其他操作时。

SW_RESTORE：恢复窗口的原始大小和位置。如果窗口之前是最小化或最大化状态，这个操作会将其恢复到之前的正常大小和位置。

3. 返回值

函数返回一个BOOL类型的值。如果函数成功地设置了窗口的显示状态，返回非零值（TRUE）；如果发生错误，比如传递了无效的窗口句柄或者不合法的nCmdShow参数，函数返回零（FALSE）。

4. 示例代码

以下是一个简单的示例，展示了ShowWindow函数在WinMain函数中的使用：

#include <windows.h>
LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM);
int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance,
    PSTR szCmdLine, int iCmdShow)
{
    WNDCLASSEX wcex;
    // 填充WNDCLASSEX结构体并注册窗口类，代码省略
    if (!RegisterClassEx(&wcex))
    {
        return 0;
    }
    HWND hWnd = CreateWindowEx(0, wcex.lpszClassName, "My Window",
    WS_OVERLAPPEDWINDOW, CW_USEDEFAULT, CW_USEDEFAULT,
    CW_USEDEFAULT, CW_USEDEFAULT, NULL, NULL, hInstance, NULL);
    if (hWnd == NULL)
    {
        return 0;
    }
    // 使用ShowWindow函数显示窗口，以正常方式显示（SW_SHOWNORMAL）
    ShowWindow(hWnd, SW_SHOWNORMAL);
    UpdateWindow(hWnd);
    MSG msg;
    while (GetMessage(&msg, NULL, 0, 0))
    {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }
    return msg.wParam;
}
LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
{
    switch (message)
    {
        case WM_DESTROY:
            PostQuitMessage(0);
            break;
        default:
            return DefWindowProc(hWnd, message, wParam, lParam);
    }
    return 0;
}

在这个示例中，在WinMain函数中创建窗口后，使用ShowWindow(hWnd, SW_SHOWNORMAL)将窗口以正常方式显示。这里hWnd是之前创建窗口时获取的窗口句柄，SW_SHOWNORMAL表示以正常大小和位置显示窗口。之后通过UpdateWindow函数更新窗口，然后进入消息循环来处理窗口消息。

C++编程API库