Window下拖放操作Drag & Drop 全解析

 

OLE拖放实现

MFC本身的CView类是支持拖放操作的，通过研究CView类的源码，大体知道它的实现原理是这样的：CView类中有一个COleDropTarget类的对象，在视图窗口初始化时，调用COleDropTarget类成员函数Register()，以此在系统中注册该视图窗口为拖放接收窗口。当进行拖放操作的鼠标指针处于视图窗口范围内时，COleDropTarge类会做出反应，它的OnDragEnter、OnDragOver、OnDropEx、OnDrop等成员函数被依次调用，这些函数默认均是调用与其相对应的CView类成员函数OnDragEnter、OnDragOver、OnDropEx、OnDrop等，程序员只需重载这些CView类成员函数，即可对拖动的过程及结果进行控制。

因为COleDropTarget默认只对CView提供支持，所以如果要让其他的窗口支持拖放，我们必须同时对要支持拖放的窗口类和COleDropTarget类进行派生。把对拖放操作具体进行处理的代码封装成派生窗口类的成员函数，然后重载COleDropTarget中对应的五个虚函数，当它接收到拖放动作时，调用窗口派生类的处理函数即可。但这里有一个问题，就是我们怎么知道何时调用派生类的处理函数呢？答案是运用RTTI技术。如果COleDropTarget派生类收到的窗口指针类型，就是我们派生的窗口类，那么就调用它的处理函数，否则调用基类进行处理。

首先生成一个对话框工程，添加二个新类。

第一个类名为CListCtrlEx，父类为CListCtrl。添加完毕后，在CListCtrlEx的定义头文件中加入DECLARE_DYNAMIC(CListCtrlEx)，在其实现文件中加入IMPLEMENT_DYNAMIC(CListCtrlEx,CListCtrl)，这样就对CListCtrlEx类添加了RTTI运行期类型识别（Run Time Type Information）支持。

第二个类名为COleDropTargetEx，父类为COleDataTarget。

在CListCtrlEx中添加COleDropTargetEx类的对象，并添加下列公有虚函数的声明：

       virtual BOOL Initialize();

       virtual DROPEFFECT OnDragOver(CWnd* pWnd, COleDataObject* pDataObject, DWORD dwKeyState, CPoint point);

       virtual DROPEFFECT OnDropEx(CWnd* pWnd, COleDataObject* pDataObject, DROPEFFECT dropEffect, DROPEFFECT dropList, CPoint point);

       virtual BOOL OnDrop(CWnd* pWnd, COleDataObject* pDataObject, DROPEFFECT dropEffect, CPoint point);

       virtual void OnDragLeave(CWnd* pWnd);

Initialize函数用于注册CListCtrlEx成为拖放接收窗口；

OnDragOver在拖放鼠标进入窗口时被调用。此函数的返回值决定了后续的动作的类型：如果返回DROPEFFECT_MOVE，则产生一个剪切动作；如果返回DROPEFFECT_COPY，则产生一个复制动作，如果返回DROPEFFECT_NONE，则不会产生拖放动作，因为OnDropEx、OnDrop函数将不会被调用（OnDragLeave函数仍会被调用）。

OnDropEx函数会在OnDrop函数之前调用，如果OnDropEx函数没有对拖放动作进行处理，则应用程序框架会接着调用OnDrop函数进行处理。所以必须要在派生类中重载OnDropEx函数——即使什么动作都都没有做——否则我们的OnDrop函数将不会被执行到，因为没有重载的话，将会调用基类的OnDropEx函数，而基类的OnDropEx函数对拖放是进行了处理的——尽管不是我们所想要的动作。当然你也可以把对拖放进行处理的动作放在OnDropEx中——那样就不需要重载OnDrop了。

OnDragLeave函数会在鼠标离开窗口时被调用，在此可以进行一些简单的清理工作。譬如在OnDragEnter或者OnDragOver函数中，我们改变了光标的形态，那么此时我们就应该把光标恢复过来。

这些函数中最重要的是OnDrop函数，拖放动作将在此进行处理，它的全部源码如下：

BOOL CListCtrlEx::OnDrop(CWnd* pWnd, COleDataObject* pDataObject, DROPEFFECT dropEffect, CPoint point)

{

       UINT              nFileCount = 0;

       HDROP           hDropFiles = NULL;

       HGLOBAL        hMemData = NULL;

 

       AfxMessageBox("OnDrop");

       if(pDataObject->IsDataAvailable(CF_HDROP))

       {

              hMemData = pDataObject->GetGlobalData(CF_HDROP);

              hDropFiles = (HDROP)GlobalLock((HGLOBAL)hMemData); //锁定内存块

              if(hDropFiles != NULL)

              {

                     char chTemp[_MAX_PATH+1] = {0};

                     nFileCount = DragQueryFile(hDropFiles, 0xFFFFFFFF, NULL, 0);

                     for(UINT nCur=0; nCur遍历取得每个文件名

                     {

                            ZeroMemory(chTemp, _MAX_PATH+1);

                DragQueryFile(hDropFiles, nCur, (LPTSTR)chTemp, _MAX_PATH+1);

                            AddAllFiles(chTemp);

                     }

              }

              GlobalUnlock(hMemData);

              return TRUE;

       }

       else

       {

              return FALSE;

       }

}

在第二个类COleDropTarget中添加如下对应的函数：

    virtual DROPEFFECT OnDragEnter(CWnd* pWnd, COleDataObject* pDataObject, DWORD dwKeyState, CPoint point);

    virtual DROPEFFECT OnDragOver(CWnd* pWnd, COleDataObject* pDataObject, DWORD dwKeyState, CPoint point);

       virtual DROPEFFECT OnDropEx(CWnd* pWnd, COleDataObject* pDataObject, DROPEFFECT dropEffect, DROPEFFECT dropList, CPoint point);

       virtual BOOL OnDrop(CWnd* pWnd, COleDataObject* pDataObject, DROPEFFECT dropEffect, CPoint point);

       virtual void OnDragLeave(CWnd* pWnd);

它们的动作都差不多：先用RTTI判断窗口指针pWnd的类型，如果是CListCtrlEx，则调用CListCtrlEx中对应的处理函数，否则调用基类的处理函数。以OnDrop为例：

BOOL COleDropTargetEx::OnDrop(CWnd* pWnd, COleDataObject* pDataObject, DROPEFFECT dropEffect, CPoint point)

{

       CListCtrlEx*     pListCtrlEx = NULL;

      

       ASSERT_VALID(this);

       ASSERT(IsWindow(pWnd->m_hWnd));

      

       if(pWnd->IsKindOf(RUNTIME_CLASS(CListCtrlEx)))

       {

              pListCtrlEx = (CListCtrlEx*)pWnd;

              return pListCtrlEx->OnDrop(pWnd, pDataObject, dropEffect, point);

       }

       else

       {

              return COleDropTarget::OnDrop(pWnd, pDataObject, dropEffect, point);    

       }

}

 

//倒霉的64K限制，只能再截断了：（

至此，我们成功地为CListCtrlEx添加了文件拖入操作的支持。一个完整的拖放操作，还包括拖出动作，所以必须要为该类再添加拖出操作，即，将列表中的某一项或者多项拖出成为一个文件。这就需要用到另一个类：COleDataSource。具体步骤如下：

在CListCtrlEx中加入一个COleDataSource的实例，并映射列表框的LVN_BEGINDRAG消息处理函数，在此我们添加拖出操作的代码。

实现拖出非常简单，只需要依次调用COleDataSource的三个函数即可：Empty用于清空原先对象中缓存的数据，CacheGlobalData用来缓存数据以进行拖放操作，最后调用DoDragDrop启动本次拖放操作。

但在调用之前，必须要做一些准备工作。主要的任务就是创建一伪DROPFILES结构体，并拷贝要拖放的文件名到结构体后的内存中。DROPFILES结构体定义了CF_HDROP剪贴板格式，紧跟它后面的是一系列被拖放文件的路径名。它的定义如下：

typedef struct _DROPFILES

{

    DWORD     pFiles;  //文件名起始地址

    POINT      pt;     //鼠标放下的位置，坐标由fNC成员指定

    BOOL        fNC;    //为TRUE表示适用屏幕坐标系，否则使用客户坐标系

    BOOL        fWide;  //文件名字符串是否使用宽字符

} DROPFILES, FAR* LPDROPFILES;

拖放之前的准备动作的代码如下：

uBufferSize = sizeof(DROPFILES) + uBufferSize + 1;

    hMemData = GlobalAlloc(GPTR,uBufferSize);

    ASSERT(hMemData != NULL);

      

       lpDropFiles = (LPDROPFILES)GlobalLock(hMemData); //锁定之,并设置相关成员

       ASSERT(lpDropFiles != NULL);

       lpDropFiles->pFiles = sizeof(DROPFILES);

#ifdef _UNICODE

       lpDropFiles->fWide = TRUE;

#else

       lpDropFiles->fWide = FALSE;

#endif

 

       //把选中的所有文件名依次复制到DROPFILES结构体后面(全局内存中)

       pItemPos = strSelectedList.GetHeadPosition();

       pszStart = (char*)((LPBYTE)lpDropFiles + sizeof(DROPFILES));

       while(pItemPos != NULL)

       {

              lstrcpy(pszStart, (LPCTSTR)strSelectedList.GetNext(pItemPos));

        pszStart = strchr(pszStart,'/0') + 1; //下次的起始位置是上一次结尾+1

       }

准备完毕之后就可以进行拖放了，拖放动作有DoDragDrop函数触发，其原型如下：

DROPEFFECT DoDragDrop(

DWORD dwEffects = DROPEFFECT_COPY|DROPEFFECT_MOVE|DROPEFFECT_LINK, LPCRECT lpRectStartDrag = NULL,

COleDropSource* pDropSource = NULL

);

这里，dwEffects指定了允许施加于本COleDataSource实例之上的动作集：剪切、复制或无动作。

    lpRectStartDrag指示拖放操作真正开始的矩形，如果鼠标没有移出该矩形，则拖放操作视作放弃处理。如果本成员设为NULL，则该起始矩形将为一个像素大小。

    pDropSource表明拖放所使用的COleDataSource对象。

而该函数的返回值，则表明本次拖放操作所实际产生的效果，至于具体产生何种效果，则由系统决定。譬如在拖放时按住Shift键，将产生剪切效果；按住Ctrl键，将产生复制效果，等等。

拖放的代码如下：

       m_oleDataSource.Empty();

       m_oleDataSource.CacheGlobalData(CF_HDROP, hMemData);

       DropResult = m_oleDataSource.DoDragDrop(DROPEFFECT_MOVE|DROPEFFECT_COPY);

最后一点要注意的是，在Windows NT 4.0以上的系统中，即使实际产生的是DROPEFFECT_MOVE动作，DoDragDrop函数也只返回DROPEFFECT_NONE。产生这个问题的原因在于，Windows NT 4.0的Shell会直接移动文件本身来对移动操作进行优化。返回值DROPEFFECT_MOVE最初的含义，就是通知执行拖放操作的应用程序去删除原位置上的文件。但是因为Shell已经替应用程序完成了这个（删除）动作，所以，函数返回DROPEFFECT_NONE。要想知道文件是否真的被移动了也很简单，只要在函数返回之后检查一下原位置上的文件是否存在就可以了。

Windows 9x系列的操作系统也会对移动进行同样的优化动作，但是它不会返回DROPEFFECT_NONE来代替DROPEFFECT_MOVE。详细的解释参见MS知识库Q182219。