WINDOWS API——OPENCLIPBOARD——剪切板

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

剪切板操作方法如下：(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

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