【MoreWindows工作笔记9】OleGetClipboard 访问剪切板的文本内容

关注

原创最新推荐文章于 2026-05-08 14:53:58 发布 3w 阅读 AI 写同款· GEO 优化 ›

Windows编程的剪贴板机制 Windows编程的剪贴板机制天极网2004-9-21 9:51:00 文/郎锐　　摘要：本文对Windows剪贴板机制作了深入、全面的阐述，具体内容包括：文本、位图、DSP、自定义格式剪贴板的使用和多数据项和延迟提交技术。　　关键词： VC++6.0； 剪贴板机制；数据格式；延迟提交　　Windows剪贴板　　Windows剪贴板是一种阅读详情

剪贴板系列目前有四篇，包括访问剪贴板上的文本数据，查看复制文件时剪贴板上的文件数据，枚举剪贴板上数据格式以及监视剪贴板。

目录如下：

1.《【MoreWindows工作笔记9】OleGetClipboard 访问剪切板的文本内容》

http://blog.youkuaiyun.com/morewindows/article/details/17655053

2.《【MoreWindows工作笔记10】OleGetClipboard 访问剪切板上的文件信息》

http://blog.youkuaiyun.com/morewindows/article/details/17655057

3.《【MoreWindows工作笔记11】EnumClipboardFormats剪切板内容的数据格式》

http://blog.youkuaiyun.com/morewindows/article/details/17655299

4.《【MoreWindows工作笔记12】WM_DRAWCLIPBOARD 监视剪切板》

http://blog.youkuaiyun.com/morewindows/article/details/17655429

这里很详细，也提供了丰富的示范代码，呵呵，现在微软的MSDN已经比之前改进不少了。不但实例更加丰富了，还能在下面给出评论了。

为了提高大家学习的兴趣，先看看程序运行的效果吧，先复制一些文本，然后运行程序，程序将输出剪贴板上的文本大小和文本内容。运行结果如下所示：

下面在来看下如何实现这个功能，先看看完整的源代码，然后在来讲解重点函数。

《【MoreWindows工作笔记9】OleGetClipboard 访问剪切板的文本内容》的完整源代码如下所示：

// 【MoreWindows工作笔记9】OleGetClipboard 访问剪切板的文本内容
// http://blog.youkuaiyun.com/morewindows/article/details/17655053
// By MoreWindows( http://blog.youkuaiyun.com/MoreWindows )
#include <Windows.h>
#include <ObjBase.h>
#include <iostream>
using namespace std;

void DisplayDataObject(IDataObject *pDataObject)
{
  FORMATETC fmtetc = {CF_TEXT, 0, DVASPECT_CONTENT, -1, TYMED_HGLOBAL};
  STGMEDIUM stgmedium;
  if (pDataObject->GetData(&fmtetc, &stgmedium) == S_OK)
  {
    cout<<"  剪切板数据格式上为CF_TEXT, 文本内容如下："<<endl;
    char* data = (char*)GlobalLock(stgmedium.hGlobal);
    cout<<data<<endl;
    GlobalUnlock(stgmedium.hGlobal);
    ReleaseStgMedium(&stgmedium);
  } else {
    cout<<"  剪切板数据格式不为CF_TEXT"<<endl;
  }
} 

int main()   
{
  printf("   【MoreWindows工作笔记9】OleGetClipboard 访问剪切板的文本内容\n");
  printf(" - http://blog.youkuaiyun.com/morewindows/article/details/17655053 -\n");
  printf(" -- By MoreWindows( http://blog.youkuaiyun.com/MoreWindows ) --\n\n");

  if (OleInitialize(NULL) != S_OK) return 0;
  IDataObject *pDataObject;
  // Retrieves a data object that you can use to access the contents of the clipboard.
  if (OleGetClipboard(&pDataObject) == S_OK) {
    DisplayDataObject(pDataObject);
    pDataObject->Release();
  }
  OleUninitialize();
  return 0;
}

访问剪贴板内容可以分为三步：

第一步初始化

OleInitialize、OleUninitialize这两个函数简单，就是初始化和反初始化OLE(Object Linking and Embedding)，OLE是个复杂的大东西，有兴趣可以参考参考http://msdn.microsoft.com/en-us/library/df267wkc.aspx

第二步获取剪贴板内容

通过OleGetClipboard()函数取的剪贴板内容。其函数原型如下：

HRESULT OleGetClipboard(
  _Out_  LPDATAOBJECT *ppDataObj
);

第三步剪贴板内容解析

主要是通过2个结构体——FORMATETC和STGMEDIUM。下面先看看FORMATETC，FORMATETC 是OLE数据交换的一个关键结构，对某种设备，数据，和相关媒体做了格式上的描述。其定义为：

typedef struct tagFORMATETC 
{ 
CLIPFORMAT cfFormat; // 剪贴板数据格式
DVTARGETDEVICE *ptd; // 设备有关的信息
DWORD dwAspect; // 图形数据的表现方式
LONG lindex; // dwAspect 成员的补充
DWORD tymed; // 数据的存储介质
} FORMATETC;

一个典型的 FORMATETC 结构变量定义如下：

FORMATETC cFmt = {(CLIPFORMAT) CF_TEXT, NULL, DVASPECT_CONTENT, -1, TYMED_HGLOBAL};

剪贴板数据格式在winuser.h中定义，取值如下：

// winuser.h
#ifndef NOCLIPBOARD

/*
 * Predefined Clipboard Formats
 */
#define CF_TEXT             1
#define CF_BITMAP           2
#define CF_METAFILEPICT     3
#define CF_SYLK             4
#define CF_DIF              5
#define CF_TIFF             6
#define CF_OEMTEXT          7
#define CF_DIB              8
#define CF_PALETTE          9
#define CF_PENDATA          10
#define CF_RIFF             11
#define CF_WAVE             12
#define CF_UNICODETEXT      13
#define CF_ENHMETAFILE      14
#if(WINVER >= 0x0400)
#define CF_HDROP            15
#define CF_LOCALE           16
#endif /* WINVER >= 0x0400 */
#if(WINVER >= 0x0500)
#define CF_DIBV5            17
#endif /* WINVER >= 0x0500 */
#if(WINVER >= 0x0500)
#define CF_MAX              18
#elif(WINVER >= 0x0400)
#define CF_MAX              17
#else
#define CF_MAX              15
#endif
#define CF_OWNERDISPLAY     0x0080
#define CF_DSPTEXT          0x0081
#define CF_DSPBITMAP        0x0082
#define CF_DSPMETAFILEPICT  0x0083
#define CF_DSPENHMETAFILE   0x008E
/*
 * "Private" formats don't get GlobalFree()'d
 */
#define CF_PRIVATEFIRST     0x0200
#define CF_PRIVATELAST      0x02FF
/*
 * "GDIOBJ" formats do get DeleteObject()'d
 */
#define CF_GDIOBJFIRST      0x0300
#define CF_GDIOBJLAST       0x03FF

#endif /* !NOCLIPBOARD */

看完了 FORMATETC 结构体，再来看看 STGMEDIUM 结构体：

typedef struct tagSTGMEDIUM {
  DWORD    tymed;
  union {
    HBITMAP       hBitmap;
    HMETAFILEPICT hMetaFilePict;
    HENHMETAFILE  hEnhMetaFile;
    HGLOBAL       hGlobal;
    LPOLESTR      lpszFileName;
    IStream       *pstm;
    IStorage      *pstg;
  };
  IUnknown *pUnkForRelease;
} STGMEDIUM, *LPSTGMEDIUM;

这里很巧妙的使用了union来存储不同类型的句柄指针。

使用IDataObject类的GetData()函数可以根据FORMATETC的值取出相应的STGMEDIUM数据，注意最后要调用ReleaseStgMedium()来释放STGMEDIUM数据

下一篇《【MoreWindows工作笔记10】OleGetClipboard访问剪切板上的文件信息

》（http://blog.youkuaiyun.com/morewindows/article/details/17655057）将介绍在复制粘贴文件时，剪贴板会存储什么格式的数据，如何使用这些数据，欢迎继续浏览。

本文地址：http://blog.youkuaiyun.com/morewindows/article/details/17655053 转载请标明出处，谢谢。

欢迎关注微博：http://weibo.com/MoreWindows