c++如何读取系统剪贴板中的文本_Windows API调用【技巧】-C++-PHP中文网

OpenClipboard失败需先确保线程拥有消息队列，可用PeekMessage触发创建；读取剪贴板应优先用CF_UNICODETEXT避免乱码，GlobalLock后须配对GlobalUnlock，读取后若需保留内容应重新SetClipboardData。

c++如何读取系统剪贴板中的文本_windows api调用【技巧】

OpenClipboard 失败返回 false 怎么办

调用 OpenClipboard 失败，最常见原因是当前线程没关联消息队列（比如控制台程序默认无窗口、无消息循环）。Windows 剪贴板是线程关联的，必须由拥有窗口或已调用 RegisterClass + CreateWindow（或至少 PeekMessage 触发隐式创建）的线程操作。

控制台程序可先调用 AllocConsole，再用 CreateWindow 创建一个隐藏窗口（WS_POPUP | WS_DISABLED），然后将该窗口句柄传给 OpenClipboard
更轻量的做法：在调用 OpenClipboard 前，插入一次 PeekMessage(&msg, nullptr, 0, 0, PM_NOREMOVE)，强制系统为当前线程创建消息队列
若已存在其他窗口，直接传其句柄（如 GetConsoleWindow() 在控制台中通常可用）

GlobalLock 返回 nullptr 或乱码怎么办

成功调用 GetClipboardData(CF_TEXT) 后，GlobalLock 返回 nullptr 说明内存对象无效；返回非空但读出来是乱码，大概率是编码问题——CF_TEXT 强制按 ANSI 编码（系统本地代码页），而现代剪贴板内容多为 UTF-16（尤其来自浏览器、VS Code 等）。

优先尝试 CF_UNICODETEXT：用 GetClipboardData(CF_UNICODETEXT) 获取 HGLOBAL，再 GlobalLock 得到 wchar_t*，可直接转 std::wstring
若需 UTF-8 输出，用 WideCharToMultiByte(CP_UTF8, ...) 转换，别直接 reinterpret_cast
GlobalLock 后必须配对 GlobalUnlock，否则后续 OpenClipboard 可能失败

读取后粘贴内容消失或被清空

不是你清的，是 Windows 的“延迟渲染”机制在作怪。很多程序（如 Chrome）注册了 CF_UNICODETEXT 但不真正提供数据，直到你调用 GetClipboardData 时才生成。此时若你只读不保留所有权，系统可能认为数据已被消费完毕，自动清空。

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

读取后立即调用 SetClipboardData(CF_UNICODETEXT, hMem) 把数据重新设回去（hMem 需用 GlobalAlloc(GMEM_MOVEABLE, ...) 分配并复制）
或者更稳妥：全程不调用 EmptyClipboard，且在 CloseClipboard 前不做任何写操作
注意：SetClipboardData 要求调用线程拥有剪贴板所有权（即刚成功 OpenClipboard 且未被其他线程抢占）

完整最小可运行示例（控制台环境）

#include <windows.h>
#include <string>
#include <iostream><p>std::wstring ReadClipboardText() {
if (!OpenClipboard(GetConsoleWindow())) return L"";
std::wstring result;
HANDLE hData = GetClipboardData(CF_UNICODETEXT);
if (hData) {
wchar_t<em> wch = static_cast<wchar_t>>(GlobalLock(hData));
if (wch) {
result = wch;
GlobalUnlock(hData);
}
}
CloseClipboard();
return result;
}</wchar_t></em></p>
<p>int main() {
// 防止因无消息队列导致 OpenClipboard 失败
MSG msg;
PeekMessage(&msg, nullptr, 0, 0, PM_NOREMOVE);</p>
<pre class="brush:php;toolbar:false;">auto text = ReadClipboardText();
std::wcout <p>}
</p>

关键点：没显式创建窗口，靠 PeekMessage 触发消息队列初始化；只读不写，避免干扰原剪贴板状态；使用 CF_UNICODETEXT 覆盖绝大多数现代应用输出。

真正麻烦的不是读，是处理不同来源对剪贴板格式的“协商”逻辑——比如某程序同时提供 CF_UNICODETEXT 和 CF_HTML，你得自己判断优先级；还有图像、文件列表等非文本格式，需要完全不同的解析路径。