Windows API按钮主题设置故障：如何让按钮文字始终显示红色？

开发者阿泽

2026-7-24

问题分析与解决方案

你的问题出在错误地在主窗口的WM_PAINT消息中绘制按钮文本，且未正确处理按钮自身的绘制逻辑。主窗口与按钮是独立的窗口实体，各自拥有独立的WM_PAINT消息循环，当前做法会导致绘制时机冲突，从而出现窗口移动前显示异常的情况。

核心错误点

主窗口WM_PAINT中绘制按钮文本的逻辑，会与按钮自身的默认绘制逻辑冲突：初始状态下按钮的默认绘制会覆盖你设置的红色文本，窗口移动触发全局重绘后才会显示正常。
使用GetDC(hWnd)获取的是主窗口的设备上下文（DC），而非按钮的DC，且未转换绘制坐标，导致绘制区域错位。
主窗口的WM_PAINT未调用BeginPaint和EndPaint，违反Win32绘制规范，会导致系统判定窗口未完成绘制，引发异常。

正确方案一：子类化按钮，接管按钮绘制逻辑

通过子类化按钮窗口，在按钮自身的WM_PAINT消息中处理红色文本绘制，确保按钮绘制完全受你控制，避免逻辑冲突。

步骤1：定义按钮子类的窗口过程

LRESULT CALLBACK ButtonSubclassProc(HWND hBtn, UINT uMsg, WPARAM wParam, LPARAM lParam, UINT_PTR uIdSubclass, DWORD_PTR dwRefData)
{
    switch (uMsg)
    {
        case WM_PAINT:
        {
            PAINTSTRUCT ps;
            HDC hdc = BeginPaint(hBtn, &ps);

            RECT rc;
            GetClientRect(hBtn, &rc);

            HTHEME theme = OpenThemeData(hBtn, L"button");
            if (theme)
            {
                DTTOPTS opts = { 0 };
                opts.dwSize = sizeof(opts);
                opts.crText = RGB(255, 0, 0);
                opts.dwFlags = DTT_TEXTCOLOR | DTT_COMPOSITED;

                WCHAR caption[256];
                GetWindowText(hBtn, caption, ARRAYSIZE(caption));

                // 保留主题样式绘制按钮背景
                DrawThemeBackground(theme, hdc, BP_PUSHBUTTON, CBS_UNCHECKEDNORMAL, &rc, NULL);
                // 绘制红色文本
                DrawThemeTextEx(theme, hdc, BP_PUSHBUTTON, CBS_UNCHECKEDNORMAL,
                                caption, -1, DT_CENTER | DT_VCENTER | DT_SINGLELINE,
                                &rc, &opts);

                CloseThemeData(theme);
            }
            else
            {
                // 无主题时的降级绘制逻辑
                SetTextColor(hdc, RGB(255, 0, 0));
                SetBkMode(hdc, TRANSPARENT);
                WCHAR caption[256];
                GetWindowText(hBtn, caption, ARRAYSIZE(caption));
                DrawText(hdc, caption, -1, &rc, DT_CENTER | DT_VCENTER | DT_SINGLELINE);
            }

            EndPaint(hBtn, &ps);
            return 0; // 阻止按钮默认绘制
        }
        case WM_DESTROY:
            // 销毁时取消子类化
            RemoveWindowSubclass(hBtn, ButtonSubclassProc, 0);
            break;
    }
    // 其他消息交给原窗口过程处理
    return DefSubclassProc(hBtn, uMsg, wParam, lParam);
}

步骤2：创建按钮后立即子类化

在你的按钮创建代码后添加子类化调用：

GetClientRect(hWnd, &rect);
hButton = CreateWindowExW(
    0L, 
    L"BUTTON",
    L"Hello, World!!!", 
    WS_VISIBLE | WS_CHILD | BS_PUSHBUTTON | BS_FLAT,
    rect.right / 2 - 100,
    rect.bottom / 2 - 25,
    200, 
    50, 
    hWnd, 
    NULL, 
    ((LPCREATESTRUCT)lParam)->hInstance,
    NULL);

// 子类化按钮，接管绘制
SetWindowSubclass(hButton, ButtonSubclassProc, 0, 0);

步骤3：修正主窗口的WM_PAINT处理

主窗口的WM_PAINT仅处理自身绘制，不要干预子控件：

case WM_PAINT:
{
    PAINTSTRUCT ps;
    HDC hdc = BeginPaint(hWnd, &ps);
    // 主窗口自身的绘制逻辑（如有）
    EndPaint(hWnd, &ps);
    break;
}

正确方案二：使用自绘制按钮（BS_OWNERDRAW）

若不想子类化，可将按钮设置为BS_OWNERDRAW样式，在主窗口的WM_DRAWITEM消息中处理绘制：

步骤1：修改按钮创建代码，添加BS_OWNERDRAW

hButton = CreateWindowExW(
    0L, 
    L"BUTTON",
    L"Hello, World!!!", 
    WS_VISIBLE | WS_CHILD | BS_PUSHBUTTON | BS_FLAT | BS_OWNERDRAW, // 添加自绘制样式
    rect.right / 2 - 100,
    rect.bottom / 2 - 25,
    200, 
    50, 
    hWnd, 
    NULL, 
    ((LPCREATESTRUCT)lParam)->hInstance,
    NULL);

步骤2：在主窗口过程中处理WM_DRAWITEM

case WM_DRAWITEM:
{
    LPDRAWITEMSTRUCT lpDIS = (LPDRAWITEMSTRUCT)lParam;
    if (lpDIS->hwndItem == hButton)
    {
        HDC hdc = lpDIS->hDC;
        RECT rc = lpDIS->rcItem;

        // 根据按钮状态绘制背景
        if (lpDIS->itemState & ODS_SELECTED)
        {
            FillRect(hdc, &rc, (HBRUSH)(COLOR_BTNSHADOW + 1));
        }
        else
        {
            FillRect(hdc, &rc, (HBRUSH)(COLOR_BTNFACE + 1));
        }

        // 绘制红色文本
        SetTextColor(hdc, RGB(255, 0, 0));
        SetBkMode(hdc, TRANSPARENT);
        WCHAR caption[256];
        GetWindowText(hButton, caption, ARRAYSIZE(caption));
        DrawText(hdc, caption, -1, &rc, DT_CENTER | DT_VCENTER | DT_SINGLELINE);

        return TRUE;
    }
    break;
}

关键说明

两种方案的核心都是让按钮的绘制逻辑由自身（子类化）或主窗口的自绘制消息（WM_DRAWITEM）处理，禁止在主窗口WM_PAINT中直接绘制子控件。
子类化方案更适合保留系统主题样式，自绘制方案则完全由你控制按钮外观，灵活性更高。

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