您的位置：首页 > 运维架构

使用IDropTarget接口同时支持文本和文件拖放(一)

2008-11-04 10:58 841 查看
使用IDropTarget接口同时支持文本和文件拖放(一)
2008-01-12 07:46
使用IDropTarget接口同时支持文本和文件拖放（转）

最近在写Shell Extension方面的东西，看到了这篇文章，抄在这里。
原文地址http://blog.csdn.net/vcbear/archive/2002/01/25/5990.aspx
同时也找到了一个与Drag and Drop有关的例子，地址：http://www.codeproject.com/useritems/NSExtDragDrop.asp
vcbear
关于Windows 的外壳扩展编程，拖放是比较简单的一种，在网上可以找到不少介绍这个技巧的文章。大部分是介绍使用 MFC 的 COleDropTarget 实现的，我觉得一般使用 COleDropTarget 已经很好了，但是我习惯在一些程序模块中，完全的不使用 MFC, 比如纯 SDK 编程 , 还有用在 ATL 的时候 ,MFC 是相当累赘的。所以 COleDropTarget 在这个意义上讲不够完美。
参考了MSDN 以及 www.CodeProject.com 的相关文章和代码（ by Thomas Blenkers ）之后，我发现拖放实际上主要使用了 IDropTarget 的接口方法，非常简单，不妨直接面对原始 IDropTarget 实现自己的拖放类。
作为学习笔记，就有了这么一篇文字,以抛砖引玉：
IDropTarget是系统留给支持拖放的客户程序的一个纯虚接口，事先没有对接口的任何函数进行实现，而是让用户通过实现接口函数来接管拖放的结果。IDropTarget接口有以下成员函数：

基本
COM成员函数


QueryInterface
AddRef
Release


接管拖放事件的成员函数：

随时跟踪鼠标和键盘的状态，根据状态决定调用其
从这些接口获取客户程序的返回值，根据这些值和用户界面以及数据源进行交互。
可以说
DragEnter


DragEnter
DragOver
DragLeave
Drop
也就是说，要在客户程序里实现以上7个函数的实体。
系统在检测到拖放发生的时候，会在合适的时候依次调用客户程序里实现的IDropTarget接口相应函数，检查用户在这些函数里返回的标志，决定鼠标外观表现和拖放结果。


实现IDropTarget接口
为此建立一个基类为IDropTarget的类：
class CDropTargetEx : public IDropTarget
IDropTarget接口在OLEIDL.h里定义，为纯虚接口。
在CDropTargetEx里依次声明接口所包含的7个函数，原形为：
HRESULT STDMETHODCALLTYPE QueryInterface(REFIID iid, void ** ppvObject);
ULONG STDMETHODCALLTYPE AddRef(void);
ULONG STDMETHODCALLTYPE Release(void);
HRESULT STDMETHODCALLTYPE DragOver(DWORD grfKeyState,

POINTL pt,
DWORD *pdwEffect);
HRESULT STDMETHODCALLTYPE DragEnter(IDataObject * pDataObject,

DWORD grfKeyState, POINTL pt,
DWORD * pdwEffect);
HRESULT STDMETHODCALLTYPE DragLeave(void);
HRESULT STDMETHODCALLTYPE Drop(IDataObject *pDataObj,

DWORD grfKeyState,
POINTL pt,
DWORD __RPC_FAR *pdwEffect);
(为了实现Addref计数，还有一个ULONG tb_RefCount成员变量是必须的。QueryInterface，AddRef,Release这3个函数的实现是COM知识中最基本的，请参见附例)
在讲解IDropTarget其他函数的具体实现之前，有必要介绍一下一个你可能永远不会直接调用但是确实存在的函数：DoDragDrop函数.此函数在某数据源的数据被拖动的时候就被调用，它负责

检测目标窗口是否支持拖放，发现目标窗口的
IDropTarget接口
DrageEnter,DragMove,Drop或DragLeave接口
DoDragDrop控制拖放的整个过程，我们要做的，只是将这个过程里发生的事件，接管下来并得到相应的信息，和DoDragDrop进行交互而已。了解了这一点有助于我们理解为什么通过区区一个接口4个函数就可以实现了拖放的效果，因为系统为我们已经做了很多。
另一个非常重要的API是RegisterDragDrop，这个函数的原形是这样的：
WINOLEAPI RegisterDragDrop(

HWND hwnd,
IDropTarget * pDropTarget
);
不用被WINOLEAPI吓到，这是一个宏:
#define STDAPI EXTERN_C HRESULT STDAPICALLTYPE
也就是表示一个标准的WIN API函数，返回一个HRESULT的值。
函数RegisterDragDrop的作用是告诉系统:某个窗口（hwnd参数指定）可以接受拖放，接管拖放的接口是pDropTarget。
记住在调用RegisterDragDrop之前，一定要先调用OleInitialize初始化OLE环境。
在类CDropTargetEx里设计了一个函数
BOOL CDropTargetEx::DragDropRegister(HWND hWnd,
DWORD AcceptKeyState=|MK_LBUTTON)
{
if(!IsWindow(hWnd))return false;
HRESULT s = ::RegisterDragDrop (hWnd,this);
if(SUCCEEDED(s))
{
m_hTargetWnd = hWnd;
m_AcceptKeyState = AcceptKeyState;
return true;
}
else { return false; }
}
在这个函数里调用RegisterDragDrop,将this指针传入，表示本类实现了IDropTarget.，由本类接管拖放事件。另外顺便定义了一下拖放鼠标和键盘特性常数，对这个类来说，我希望默认的只接受鼠标左键的拖放，所以，默认的AcceptKeyState值是MK_LBUTTON。相关的键盘鼠标常数还有MK_SHIFT,MK_ALT,MK_RBOTTON,MK_MBUTTON,MK_BOTTON等几个，我想这个几个常数从字面上就可以理解它的意思了。这些常数可以用“位与”的操作组合。
以下具体讨论IDropTarget的拖放相关接口函数（4个），这里的拖放对象以文本和文件为主。

当你用鼠标选中了某一个文件或一段文本，并且将鼠标移到某个可以接受拖放（已经调用过RegisterDragDrop）的窗口里，DragEnter将第一时间被调用。再看一下其原形：
HRESULT DragEnter( IDataObject * pDataObject,

DWORD grfKeyState,
POINTL pt,
DWORD * pdwEffect )
pDataobject是从拖放的原数据中传递过来的一个IDataObject接口实例，包含数据对象的一些相关方法，可以通过此接口获得数据。
grfKeyState为DragEnter被调用时当前的键盘和鼠标的状态，包含上面介绍过的键盘鼠标状态常数。
pt表示鼠标所在的点。是以整个屏幕为参考坐标的。
pdwEffect是DoDragDrop提供的一个DWORD指针，客户程序通过这个指针给DoDragDrop返回特定的状态。有效的状态包括：
DROPEFFECT_NONE=0 表示此窗口不能接受拖放。
DROPEFFECT_MOVE=1 表示拖放的结果将使源对象被删除
DROPEFFECT_COPY=2 表示拖放将引起源对象的复制。
DROPEFFECT_LINK =4 表示拖放源对象创建了一个对自己的连接
DROPEFFECT_SCROLL=0x80000000表示拖放目标窗口正在或将要进行卷滚。此标志可以和其他几个合用
对于拖放对象来说，一般只要使用DROPEFFECT_NONE和DROPEFFECT_COPY即可。
在DragEnter里要做什么呢？主要是告知拖放已经进入窗口区域，并判断是否支持某具体类型的拖放。
首先,要判断键盘的状态。在调用DragDropRegister时我传入了一个AcceptKeyState并将其保存在m_AcceptKeyState成员变量里，现在可以拿它跟这里得到的grfKeyState比较：
if(grfKeyState!=m_AcceptKeyState )
{
*pdwEffect = DROPEFFECT_NONE;
return S_OK;
}
如果键盘和鼠标的状态和我期望的不一样，那么pdwEffect里返回DROPEFFECT_NONE表示不接受拖放。
然后,判断拖放过来的IDataObject对象里有没有我感兴趣的数据。
这里要介绍的是两个关键的结构体FORMATETC和STDMEDIUM
FORMATETC是OLE数据交换的一个关键结构，对某种设备，数据，和相关媒体做了格式上的描述。
其定义为
typedef struct tagFORMATETC
{

CLIPFORMAT cfFormat;
DVTARGETDEVICE *ptd;
DWORD dwAspect;
LONG lindex;
DWORD tymed;
}FORMATETC, *LPFORMATETC;
内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 点击这里给我发消息
标签： 
相关文章推荐
新的分享
章节导航