Win32 API创建OpenGL窗口时标题栏空白问题求助

我用C语言开发了一个用于创建OpenGL环境的Win32窗口库，但遇到了窗口标题栏空白的问题——本该显示标题的区域没有内容。以下是相关代码文件：

window.c #

#include "window.h"

LRESULT CALLBACK WndProc(HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam) {
    struct WindowClass* window = (struct WindowClass*)GetWindowLongPtr(hwnd, GWLP_USERDATA);
    switch (msg)
    {
        case WM_NCCREATE: {
            CREATESTRUCT* cs = (CREATESTRUCT*)lParam;
            SetWindowLongPtr(hwnd, GWLP_USERDATA, (LONG_PTR)cs->lpCreateParams);
            return TRUE;
        }

        case WM_CLOSE:
            if (window) window->shouldClose = true;
            return 0;

        case WM_DESTROY:
            PostQuitMessage(0);
            return 0;
    }

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

bool init() {
    WNDCLASSW wc = {
        .style = CS_OWNDC,
        .lpfnWndProc = WndProc,
        .hInstance = GetModuleHandle(NULL),
        .lpszClassName = L"WindowClass",
        .hCursor = LoadCursor(NULL, IDC_ARROW),
        .hbrBackground = NULL
    };

    if (!RegisterClassW(&wc)) return false;

    return true;
}

struct WindowClass* createWindow(const wchar_t* title, int width, int height) {
    struct WindowClass* out = malloc(sizeof(struct WindowClass));

    HWND hwnd = CreateWindowExW(0, L"WindowClass", title, WS_OVERLAPPEDWINDOW, CW_USEDEFAULT, CW_USEDEFAULT, width, height, NULL, NULL, GetModuleHandleW(NULL), out);

    if (!hwnd) {
        free(out);
        return NULL;
    }

    ShowWindow(hwnd, SW_SHOW);
    UpdateWindow(hwnd);

    HDC hdc = GetDC(hwnd);

    PIXELFORMATDESCRIPTOR pfd = {
        .nSize = sizeof(PIXELFORMATDESCRIPTOR),
        .nVersion = 1,
        .dwFlags = PFD_DRAW_TO_WINDOW | PFD_SUPPORT_OPENGL | PFD_DOUBLEBUFFER,
        .iPixelType = PFD_TYPE_RGBA,
        .cColorBits = 32,
        .cDepthBits = 24,
        .cStencilBits = 8,
        .iLayerType = PFD_MAIN_PLANE
    };

    int pf = ChoosePixelFormat(hdc, &pfd);
    SetPixelFormat(hdc, pf, &pfd);

    HGLRC hglrc = wglCreateContext(hdc);
    wglMakeCurrent(hdc, hglrc);

    out->handle = hwnd;
    out->device = hdc;
    out->render = hglrc;
    out->shouldClose = false;

    return out;
}

void update() {
    MSG msg;
        while (PeekMessage(&msg, NULL, 0, 0, PM_REMOVE)) {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }
}

void closeWindow(struct WindowClass* window) {
    wglMakeCurrent(NULL, NULL);
    wglDeleteContext(window->render);
    ReleaseDC(window->handle, window->device);
    DestroyWindow(window->handle);
    free(window);
}


void end() {
    UnregisterClassW(L"WindowClass", GetModuleHandle(NULL));

}

window.h #

#include <stdbool.h>
#include <Windows.h>
#include <windowsx.h>

struct WindowClass{
    HWND handle;
    HDC device;
    HGLRC render;
    bool shouldClose;
};

struct WindowClass* createWindow(const wchar_t* title, int width, int height);
void closeWindow(struct WindowClass* window);

bool init();
void end();

void update();

main.c #

#include "window.h"

int main() {
    if (!init()) return 1;
    struct WindowClass* window = createWindow(L"Window", 800, 600);
    while (true) {
        update();
        if (window->shouldClose) break;
    }
    closeWindow(window);
    end();
    return 0;
}

问题原因 #

标题栏空白的核心原因是窗口类注册时hbrBackground被设为NULL。Win32系统依赖窗口类的背景刷处理窗口背景绘制逻辑，当该值为NULL时，系统无法正确处理非客户区（包括标题栏）的绘制流程，导致标题栏内容无法正常渲染。

另外，窗口创建后立即设置OpenGL像素格式的操作，会提前接管窗口的绘制上下文，进一步干扰了系统默认的非客户区绘制流程。

修复方案 #

1. 修改窗口类的背景刷设置：在init()函数中，将WNDCLASSW的hbrBackground改为系统默认的窗口背景刷：

.hbrBackground = (HBRUSH)(COLOR_WINDOW + 1);

2. 调整OpenGL上下文初始化时机：将OpenGL相关的初始化代码延迟到窗口第一次收到WM_PAINT消息时执行，避免提前接管窗口上下文影响系统绘制：

• 在WndProc中添加WM_PAINT处理：

case WM_PAINT: {
    struct WindowClass* window = (struct WindowClass*)GetWindowLongPtr(hwnd, GWLP_USERDATA);
    // 只初始化一次OpenGL上下文
    if (!window->render) {
        HDC hdc = GetDC(hwnd);
        PIXELFORMATDESCRIPTOR pfd = {
            .nSize = sizeof(PIXELFORMATDESCRIPTOR),
            .nVersion = 1,
            .dwFlags = PFD_DRAW_TO_WINDOW | PFD_SUPPORT_OPENGL | PFD_DOUBLEBUFFER,
            .iPixelType = PFD_TYPE_RGBA,
            .cColorBits = 32,
            .cDepthBits = 24,
            .cStencilBits = 8,
            .iLayerType = PFD_MAIN_PLANE
        };
        int pf = ChoosePixelFormat(hdc, &pfd);
        SetPixelFormat(hdc, pf, &pfd);
        HGLRC hglrc = wglCreateContext(hdc);
        wglMakeCurrent(hdc, hglrc);
        window->device = hdc;
        window->render = hglrc;
    }
    ValidateRect(hwnd, NULL);
    return 0;
}

• 同时修改createWindow函数，移除其中的OpenGL初始化代码，只保留窗口创建和显示逻辑：

struct WindowClass* createWindow(const wchar_t* title, int width, int height) {
    struct WindowClass* out = malloc(sizeof(struct WindowClass));
    memset(out, 0, sizeof(struct WindowClass)); // 初始化成员为0，确保render为NULL

    HWND hwnd = CreateWindowExW(0, L"WindowClass", title, WS_OVERLAPPEDWINDOW, CW_USEDEFAULT, CW_USEDEFAULT, width, height, NULL, NULL, GetModuleHandleW(NULL), out);

    if (!hwnd) {
        free(out);
        return NULL;
    }

    out->handle = hwnd;
    out->shouldClose = false;

    ShowWindow(hwnd, SW_SHOW);
    UpdateWindow(hwnd);

    return out;
}

验证修复 #

修改后重新编译运行，窗口标题栏会正常显示传入的标题文本，同时OpenGL环境也能正常初始化工作。

内容的提问来源于stack exchange，提问作者user32693076