C++：SetClipboardData()设置剪贴板数据函数

1. 函数功能概述

SetClipboardData是一个Windows API函数，用于将数据放置到剪贴板中。通过这个函数，可以把文本、图像、自定义数据格式等各种类型的数据放入剪贴板，使得其他应用程序能够从剪贴板中获取这些数据。

2. 函数原型和参数

函数原型为HANDLE SetClipboardData(UINT uFormat, HANDLE hMem);。

参数说明：

uFormat：指定要放置到剪贴板中的数据格式。常见的格式有CF_TEXT（以空字符结尾的ANSI文本）、CF_UNICODETEXT（以空字符结尾的Unicode文本）、CF_BITMAP（位图）等。例如，若要将文本数据放入剪贴板，可以使用CF_TEXT或CF_UNICODETEXT格式。

hMem：是一个内存对象的句柄，这个内存对象包含了要放入剪贴板的数据。对于文本数据，通常需要先分配内存，将文本数据复制到内存中，然后将内存句柄传递给这个参数。如果数据格式是CF_BITMAP等，hMem则是相应图像资源的句柄。

3. 函数返回值

如果函数成功将数据放入剪贴板，它返回一个非零值，表示新数据的句柄。这个句柄可以在后续的操作中（如在其他应用程序从剪贴板获取数据时）使用。

如果函数调用失败，返回值为NULL。失败的原因可能包括剪贴板无法打开、内存不足或无效的数据格式等。

4. 使用示例

以下是一个将文本数据放入剪贴板的简单示例（假设包含了<windows.h>头文件）：

#include <iostream>
#include <windows.h>
int main()
{
    const char* text = "Hello, Clipboard!";
    // 打开剪贴板
    if (OpenClipboard(NULL))
    {
        // 分配全局内存并复制文本数据
        HGLOBAL hGlobal = GlobalAlloc(GMEM_MOVEABLE, strlen(text) + 1);
        if (hGlobal!= NULL)
        {
            char* pData = (char*)GlobalLock(hGlobal);
            if (pData!= NULL)
            {
                strcpy(pData, text);
                GlobalUnlock(hGlobal);
                // 将数据放入剪贴板
                SetClipboardData(CF_TEXT, hGlobal);
            }
        }
        // 关闭剪贴板
        CloseClipboard();
    }
    else
    {
        std::cerr << "无法打开剪贴板" << std::endl;
    }
    return 0;
}

在这个示例中：

首先定义了要放入剪贴板的文本text。

然后调用OpenClipboard(NULL)打开剪贴板。

接着使用GlobalAlloc分配全局内存，用于存储文本数据。通过GlobalLock获取指向内存的指针，将文本数据复制到内存中，再使用GlobalUnlock解锁内存。

最后使用SetClipboardData(CF_TEXT, hGlobal);将包含文本数据的内存句柄hGlobal放入剪贴板，数据格式为CF_TEXT，并关闭剪贴板。

5. 注意事项

在调用SetClipboardData之前，必须先成功打开剪贴板（通过OpenClipboard函数），并且在完成数据设置后，应该及时关闭剪贴板（使用CloseClipboard函数），以确保系统资源的正确使用和其他应用程序能够正常访问剪贴板。

对于传递给SetClipboardData的内存句柄hMem，其内存管理方式与具体的数据格式有关。对于一些数据格式，如CF_TEXT和CF_UNICODETEXT，通常需要使用GlobalAlloc等函数来分配全局内存，并且在放入剪贴板后，系统会接管这块内存的管理。而对于其他格式，可能有不同的内存要求和管理方式。

如果应用程序要将复杂的数据结构或自定义格式的数据放入剪贴板，可能需要进行更复杂的内存管理和数据格式化操作，以确保其他应用程序能够正确地识别和获取数据。

C++编程API库