基于Win32 API实现C++编辑控件灰色文本水印的技术咨询

嘿，很高兴你在探索Win32编辑控件的水印实现！除了你提到的WM_KEYDOWN方法，还有几个更优雅或者兼容性更好的方案，我给你梳理一下：

1. 利用系统自带的EM_SETCUEBANNER消息（推荐，Vista及以上） #

这个方法是最省心的——从Windows Vista开始，系统已经原生支持编辑控件的水印提示，不需要自己写绘制逻辑。你只需要给编辑控件发送EM_SETCUEBANNER消息，传入水印文本即可，甚至可以设置是否在控件获得焦点时仍显示水印。

代码示例： #

// 假设hEdit是你的编辑控件句柄
// 第二个参数为TRUE表示控件获得焦点时仍显示水印，FALSE则仅在无焦点且为空时显示
SendMessage(hEdit, EM_SETCUEBANNER, TRUE, (LPARAM)L"请输入用户名");

注意：如果你的程序使用ANSI编码，对应的消息是EM_SETCUEBANNERA，文本参数用char类型即可。

2. 自定义WM_PAINT绘制（兼容旧系统） #

如果需要兼容Windows XP这类不支持EM_SETCUEBANNER的旧系统，自定义绘制是更稳妥的选择。核心思路是：当编辑控件为空且未获得焦点时，在控件客户区绘制灰色的水印文本。

代码示例（在编辑控件的窗口过程中处理）： #

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

    // 先让系统完成默认的编辑控件绘制
    DefWindowProc(hwnd, WM_PAINT, (WPARAM)hdc, (LPARAM)&ps);

    // 检查控件是否为空且无焦点
    WCHAR buffer[256];
    GetWindowText(hwnd, buffer, ARRAYSIZE(buffer));
    if (wcslen(buffer) == 0 && GetFocus() != hwnd)
    {
        // 保存原文本颜色，设置为灰色
        COLORREF oldTextColor = SetTextColor(hdc, RGB(128, 128, 128));
        // 设置文本背景透明，避免覆盖控件原有背景
        SetBkMode(hdc, TRANSPARENT);

        // 获取控件客户区，微调内边距让文本不紧贴边框
        RECT clientRect;
        GetClientRect(hwnd, &clientRect);
        clientRect.left += 2;
        clientRect.top += 2;

        // 绘制水印文本
        DrawText(hdc, L"请输入内容", -1, &clientRect, DT_LEFT | DT_VCENTER | DT_SINGLELINE);

        // 恢复原文本颜色
        SetTextColor(hdc, oldTextColor);
    }

    EndPaint(hwnd, &ps);
    return 0;
}
// 别忘了处理WM_SETFOCUS和WM_KILLFOCUS，触发重绘
case WM_SETFOCUS:
case WM_KILLFOCUS:
    InvalidateRect(hwnd, NULL, TRUE);
    return DefWindowProc(hwnd, uMsg, wParam, lParam);

3. 子类化编辑控件（复用性强） #

如果你的程序里有多个需要水印的编辑控件，子类化是更高效的做法——把水印绘制逻辑封装到子类窗口过程中，所有需要的控件都可以复用这个逻辑，避免重复代码。

代码示例： #

#include <commctrl.h>
#pragma comment(lib, "comctl32.lib")

// 子类窗口过程，dwRefData用来传递水印文本
LRESULT CALLBACK EditSubclassProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam, UINT_PTR uIdSubclass, DWORD_PTR dwRefData)
{
    switch (uMsg)
    {
        case WM_PAINT:
        {
            PAINTSTRUCT ps;
            HDC hdc = BeginPaint(hwnd, &ps);
            // 调用原控件的默认绘制逻辑
            DefSubclassProc(hwnd, WM_PAINT, (WPARAM)hdc, (LPARAM)&ps);

            WCHAR buffer[256];
            GetWindowText(hwnd, buffer, ARRAYSIZE(buffer));
            if (wcslen(buffer) == 0 && GetFocus() != hwnd)
            {
                COLORREF oldColor = SetTextColor(hdc, RGB(128, 128, 128));
                SetBkMode(hdc, TRANSPARENT);
                RECT rc;
                GetClientRect(hwnd, &rc);
                rc.left += 2; rc.top += 2;
                // dwRefData是传入的水印文本
                DrawText(hdc, (LPCWSTR)dwRefData, -1, &rc, DT_LEFT | DT_VCENTER | DT_SINGLELINE);
                SetTextColor(hdc, oldColor);
            }
            EndPaint(hwnd, &ps);
            return 0;
        }
        case WM_SETFOCUS:
        case WM_KILLFOCUS:
            InvalidateRect(hwnd, NULL, TRUE);
            break;
        case WM_DESTROY:
            // 控件销毁时移除子类
            RemoveWindowSubclass(hwnd, EditSubclassProc, uIdSubclass);
            break;
    }
    // 调用原窗口过程
    return DefSubclassProc(hwnd, uMsg, wParam, lParam);
}

// 在创建编辑控件后，给它子类化
HWND hEdit = CreateWindowEx(0, L"EDIT", L"", WS_CHILD | WS_VISIBLE | ES_AUTOHSCROLL, 
                            10, 10, 200, 25, hWnd, (HMENU)IDC_EDIT, hInst, NULL);
// 第四个参数传递水印文本作为自定义数据
SetWindowSubclass(hEdit, EditSubclassProc, 1, (DWORD_PTR)L"请输入内容");

方案对比 #

• EM_SETCUEBANNER：代码最少，系统原生支持，无兼容性问题（Vista+），优先选择。
• 自定义WM_PAINT：兼容所有Win32系统，但需要自己处理绘制细节，适合单个控件或旧系统场景。
• 子类化控件：复用性强，适合多个需要水印的控件，代码更模块化。

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