【Windows API】OpenClipboard --- 剪切板（转）

原文转自 http://www.cnblogs.com/wind-net/archive/2012/11/01/2749558.html

剪切板：系统维护的一个全局公共内存区域.每次只允许一个进程对其进行访问。

剪切板操作方法如下：(MSDN上搜索Clipboard Operations)

1.打开剪切板 Bool OpenClipboard(HWND hWndNewOwner); 　　指定关联到打开的剪切板的窗口句柄，传入NULL表示关联到当前任务。每次只允许一个进程打开并访问。

每打开一次就要关闭，否则其他进程无法访问剪切板。

2.清空剪切板 Bool EmptyClipboard(void)

　　写入前必须先清空，得到剪切板占有权

3.分配内存 HGLOBAL GlobalAlloc(UINT uFlags, SIZE_T dwBytes); 　　在堆上动态分配以字节为单位的内存区域。成功则指向该内存，失败NULL。参数：1.分配内存属性， 2.分配的大小

4.锁定内存 LPVOID GlobalLock(HGLOBAL hMem); 　　锁定由GlobalAlloc分配的内存，并将内存对象的锁定计数器+1，成功返回指向内存对象起始地址的指针。失败NULL

系统为每个全局内存对象维护一个锁定计数器，初始为0，GlobalLock使计数器+1，GlobalUnLock计数器-1.一旦计数器值大于0，

这块内存区域将不允许被移动或删除，只有当为0时，才解除对这块内存的锁定。如果分配时GMEM_FIXED属性，计数器一直为0

5.设置剪切板 HANDLE SetClipboardData(UINT uFormat, HANDLE hMem);

　　执行成功，返回数据句柄，否则返回NULL

6.解除锁定 BOOL GlobalUnlock(HGLOBAL hMem); 　　将GlobalAlloc分配的属性为GMEM_MOVEABLE的内存对象计数器-1.

7.关闭剪切板 Bool CloseClipboard(void);

　　必须关闭剪切板其他进程才能使用剪切板，且关闭后当前进程就不能写入数据。

8.获取剪切板数据 HANDLE GetClipboardData(UINT uFormat);

　　执行成功，返回数据句柄，否则返回NULL数据格式，指定格式的数据的句柄

一：UINT uFormate格式说明：标准剪贴簿数据格式

Windows支持不同的预先定义剪贴簿格式， 这些格式在WINUSER.H定义成以CF为前缀的标识符。

■三种能够储存在剪贴簿上的文字数据型态:

①CF_TEXT    以NULL结尾的ANSI字符集字符串。它在每行末尾包含一个carriage  return和linefeed字符，这是最简单的剪贴簿数据格式。

②CF_OEMTEXT    含有文字数据（与CF_TEXT类似）的内存块。但是它使用的是OEM字符集。

③CF_UNICODETEXT    含有Unicode文字的内存块。与CF_TEXT类似，它在每一行的末尾包含一个carriage  return和linefeed字符，以及一个NULL字符（两个0字节）以表示数据结束。CF_UNICODETEXT只支援Windows NT。

■两种附加的剪贴簿格式、但是它们不需要以NULL结尾，因为格式已经定义了数据的结尾。

①CF_SYLK　　　　包含Microsoft 「符号连结」数据格式的整体内存块。这种格式用在Microsoft的Multiplan、Chart和Excel程序之间交换数据，它是一种ASCII码格式。

②CF_DIF    包含数据交换格式(DIF)之数据的整体内存块。用于把数据送到VisiCalc电子表格程序中。这也是一种ASCII码格式

■下面三种剪贴簿格式与位图有关。所谓位图就是数据位的矩形数组

①CF_BITMAP    与设备相关的位图格式。位图是通过位图句柄传送给剪贴簿的。

②CF_DIB    定义一个设备无关位图的内存块。

③CF_PALETTE    调色盘句柄。

■下面是两个metafile格式、metafile就是一个以二进制格式储存的画图命令集

①CF_METAFILEPICT    以旧的metafile格式存放的「图片」 。

②CF_ENHMETAFILE    增强型metafile（32位Windows支持的）句柄。

■最后介绍几个混合型的剪贴簿格式：

CF_PENDATA与Windows的笔式输入扩充功能联合使用。

CF_WAVE声音（波形）文件。

CF_RIFF使用资源交换文件格式（Resource Interchange File Format）的多媒体数据。

CF_HDROP与拖放服务相关的文件列表。

二：UINT uFlags格式说明：内存属性

GMEM_FIXED

　　分配一块固定的内存区域，不允许系统移动，这时返回值是一个指针。

GMEM_MOVEABLE

　　分配一块可移动的内存区域，实际上内存块在物理内存中是不可移动的，这里的可移动指的是在应用程序的默认逻辑堆内可以移动。返回值是内存对象的句柄。可以通过调研GlobalLock()函数将一个句柄转化为一个指针，这个标志不能喝GMEM_FIXED 同时使用

GMEM_ZEROINT 　　

　　初始化内存对象为全0，如果不用这个标志，内存对象将为不确定的内容

GHND

　　GMEM_MOVEABLE和GMEM_ZEROINT块标志联合使用，即可移动同时初始化为0

GPTR

　　GMEM_FIXED和GMEM_ZEROINT标志联合使用，即不可移动同时初始化为0

1. 将数据保存到剪切板

void  CMFC_TabCtrlDlg::SetClipBoardData_(CString strText)
{
    /*
    OpenClipboard打开剪切板：指定关联到打开的剪切板的窗口句柄，传入NULL表示关联到当前任务。每次只允许一
    个进程打开并访问。每打开一次就要关闭，否则其他进程无法访问剪切板。
    EmptyClipboard清空剪切板：写入前必须先清空，得到占有权
    */
    if (::OpenClipboard(m_hWnd) &&::EmptyClipboard())
    {
        //根据环境变量获取数据长度
        size_t cbStr = (strText.GetLength() + ) * sizeof(TCHAR);

        //在堆上动态分配以字节为单位的全局内存区域。成功则指向该内存，失败NULL。参数：1.分配内存属性，2.大小
        HGLOBAL hMem = GlobalAlloc(GMEM_MOVEABLE, cbStr); 

        if (hMem == NULL)
        {
            //关闭剪切板,释放剪切板所有权，关闭后就不能写入数据
            CloseClipboard();
            return;
        }

        //锁定由GlobalAlloc分配的内存，并将内存对象的锁定计数器+1；成功返回指向内存对象起始地址的指针。失败NULL
        LPTSTR lpDest = (LPTSTR)GlobalLock(hMem);
        /*
        系统为每个全局内存对象维护一个锁定计数器，初始为0，GlobalLock使计数器+1，
        */

        //拷贝数据到剪贴板内存。
        memcpy_s(lpDest, cbStr, strText.LockBuffer(), cbStr);
        strText.UnlockBuffer();

        //解除内存锁定，将属性为GMEM_MOVEABLE的内存对象计数器-1.
        GlobalUnlock(hMem);
        /*
        GlobalUnLock计数器-1.一旦计数器值大于0，这块内存区域将不允许被移动或删除，只
        有当为0时，才解除对这块内存的锁定。如果分配时GMEM_FIXED属性，计数器一直为0

        */

        //根据环境变量设置数据格式
        UINT uiFormat = (sizeof(TCHAR) == sizeof(WCHAR))?CF_UNICODETEXT:CF_TEXT;

        //设置数据到剪贴板。执行成功，返回数据句柄，否则返回NULL
        if(SetClipboardData(uiFormat, hMem) == NULL);
        {
            CloseClipboard();
            return;
        }

        CloseClipboard();
    }
}

2.从剪切板内存获取数据

void CMFC_TabCtrlDlg::GetClipBoardData_(void)
{
    //if (IsClipboardFormatAvailable(CF_UNICODETEXT)) //判断某种格式的数据是否可用
    if(::OpenClipboard(m_hWnd))
    {
        UINT uiFormat = (sizeof(TCHAR) == sizeof(WCHAR))?CF_UNICODETEXT:CF_TEXT;

        ////执行成功，返回数据句柄，否则返回NULL。参数：1.数据格式，2.指定格式的数据的句柄
        HGLOBAL hMem = GetClipboardData(uiFormat); 

        if (hMem != NULL)
        {
            //获取UNICODE的字符串。
            LPCTSTR lpStr = (LPCTSTR)GlobalLock(hMem);
            if (lpStr != NULL)
            {
                SetDlgItemText(IDC_EDIT1, lpStr);
            }
            GlobalUnlock(hMem);
        }
    }
    CloseClipboard();
}