OLE拖放實現(xiàn)
MFC本身的CView類是支持拖放操作的,通過研究CView類的源碼,大體知道它的實現(xiàn)原理是這樣的:CView類中有一個COleDropTarget類的對象,在視圖窗口初始化時,調(diào)用COleDropTarget類成員函數(shù)Register(),以此在系統(tǒng)中注冊該視圖窗口為拖放接收窗口。當進行拖放操作的鼠標指針處于視圖窗口范圍內(nèi)時,COleDropTarge類會做出反應,它的OnDragEnter、OnDragOver、OnDropEx、OnDrop等成員函數(shù)被依次調(diào)用,這些函數(shù)默認均是調(diào)用與其相對應的CView類成員函數(shù)OnDragEnter、OnDragOver、OnDropEx、OnDrop等,程序員只需重載這些CView類成員函數(shù),即可對拖動的過程及結(jié)果進行控制。
因為COleDropTarget默認只對CView提供支持,所以如果要讓其他的窗口支持拖放,我們必須同時對要支持拖放的窗口類和COleDropTarget類進行派生。把對拖放操作具體進行處理的代碼封裝成派生窗口類的成員函數(shù),然后重載COleDropTarget中對應的五個虛函數(shù),當它接收到拖放動作時,調(diào)用窗口派生類的處理函數(shù)即可。但這里有一個問題,就是我們怎么知道何時調(diào)用派生類的處理函數(shù)呢?答案是運用RTTI技術(shù)。如果COleDropTarget派生類收到的窗口指針類型,就是我們派生的窗口類,那么就調(diào)用它的處理函數(shù),否則調(diào)用基類進行處理。
首先生成一個對話框工程,添加二個新類。
第一個類名為CListCtrlEx,父類為CListCtrl。添加完畢后,在CListCtrlEx的定義頭文件中加入DECLARE_DYNAMIC(CListCtrlEx),在其實現(xiàn)文件中加入IMPLEMENT_DYNAMIC(CListCtrlEx,CListCtrl),這樣就對CListCtrlEx類添加了RTTI運行期類型識別(Run Time Type Information)支持。
第二個類名為COleDropTargetEx,父類為COleDataTarget。
在CListCtrlEx中添加COleDropTargetEx類的對象,并添加下列公有虛函數(shù)的聲明:
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函數(shù)用于注冊CListCtrlEx成為拖放接收窗口;
OnDragOver在拖放鼠標進入窗口時被調(diào)用。此函數(shù)的返回值決定了后續(xù)的動作的類型:如果返回DROPEFFECT_MOVE,則產(chǎn)生一個剪切動作;如果返回DROPEFFECT_COPY,則產(chǎn)生一個復制動作,如果返回DROPEFFECT_NONE,則不會產(chǎn)生拖放動作,因為OnDropEx、OnDrop函數(shù)將不會被調(diào)用(OnDragLeave函數(shù)仍會被調(diào)用)。
OnDropEx函數(shù)會在OnDrop函數(shù)之前調(diào)用,如果OnDropEx函數(shù)沒有對拖放動作進行處理,則應用程序框架會接著調(diào)用OnDrop函數(shù)進行處理。所以必須要在派生類中重載OnDropEx函數(shù)——即使什么動作都都沒有做——否則我們的OnDrop函數(shù)將不會被執(zhí)行到,因為沒有重載的話,將會調(diào)用基類的OnDropEx函數(shù),而基類的OnDropEx函數(shù)對拖放是進行了處理的——盡管不是我們所想要的動作。當然你也可以把對拖放進行處理的動作放在OnDropEx中——那樣就不需要重載OnDrop了。
OnDragLeave函數(shù)會在鼠標離開窗口時被調(diào)用,在此可以進行一些簡單的清理工作。譬如在OnDragEnter或者OnDragOver函數(shù)中,我們改變了光標的形態(tài),那么此時我們就應該把光標恢復過來。
這些函數(shù)中最重要的是OnDrop函數(shù),拖放動作將在此進行處理,它的全部源碼如下:
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); //鎖定內(nèi)存塊
if(hDropFiles != NULL)
{
char chTemp[_MAX_PATH+1] = {0};
nFileCount = DragQueryFile(hDropFiles, 0xFFFFFFFF, NULL, 0);
for(UINT nCur=0; nCur<nFileCount; ++nCur) //遍歷取得每個文件名
{
ZeroMemory(chTemp, _MAX_PATH+1);
DragQueryFile(hDropFiles, nCur, (LPTSTR)chTemp, _MAX_PATH+1);
AddAllFiles(chTemp);
}
}
GlobalUnlock(hMemData);
return TRUE;
}
else
{
return FALSE;
}
}
在第二個類COleDropTarget中添加如下對應的函數(shù):
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,則調(diào)用CListCtrlEx中對應的處理函數(shù),否則調(diào)用基類的處理函數(shù)。以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消息處理函數(shù),在此我們添加拖出操作的代碼。
實現(xiàn)拖出非常簡單,只需要依次調(diào)用COleDataSource的三個函數(shù)即可:Empty用于清空原先對象中緩存的數(shù)據(jù),CacheGlobalData用來緩存數(shù)據(jù)以進行拖放操作,最后調(diào)用DoDragDrop啟動本次拖放操作。
但在調(diào)用之前,必須要做一些準備工作。主要的任務就是創(chuàng)建一個DROPFILES結(jié)構(gòu)體,并拷貝要拖放的文件名到結(jié)構(gòu)體后的內(nèi)存中。DROPFILES結(jié)構(gòu)體定義了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); //鎖定之,并設(shè)置相關(guān)成員
ASSERT(lpDropFiles != NULL);
lpDropFiles->pFiles = sizeof(DROPFILES);
#ifdef _UNICODE
lpDropFiles->fWide = TRUE;
#else
lpDropFiles->fWide = FALSE;
#endif
//把選中的所有文件名依次復制到DROPFILES結(jié)構(gòu)體后面(全局內(nèi)存中)
pItemPos = strSelectedList.GetHeadPosition();
pszStart = (char*)((LPBYTE)lpDropFiles + sizeof(DROPFILES));
while(pItemPos != NULL)
{
lstrcpy(pszStart, (LPCTSTR)strSelectedList.GetNext(pItemPos));
pszStart = strchr(pszStart,'\0') + 1; //下次的起始位置是上一次結(jié)尾+1
}
準備完畢之后就可以進行拖放了,拖放動作有DoDragDrop函數(shù)觸發(fā),其原型如下:
DROPEFFECT DoDragDrop(
DWORD dwEffects = DROPEFFECT_COPY|DROPEFFECT_MOVE|DROPEFFECT_LINK, LPCRECT lpRectStartDrag = NULL,
COleDropSource* pDropSource = NULL
);
這里,dwEffects指定了允許施加于本COleDataSource實例之上的動作集:剪切、復制或無動作。
lpRectStartDrag指示拖放操作真正開始的矩形,如果鼠標沒有移出該矩形,則拖放操作視作放棄處理。如果本成員設(shè)為NULL,則該起始矩形將為一個像素大小。
pDropSource表明拖放所使用的COleDataSource對象。
而該函數(shù)的返回值,則表明本次拖放操作所實際產(chǎn)生的效果,至于具體產(chǎn)生何種效果,則由系統(tǒng)決定。譬如在拖放時按住Shift鍵,將產(chǎn)生剪切效果;按住Ctrl鍵,將產(chǎn)生復制效果,等等。
拖放的代碼如下:
m_oleDataSource.Empty();
m_oleDataSource.CacheGlobalData(CF_HDROP, hMemData);
DropResult = m_oleDataSource.DoDragDrop(DROPEFFECT_MOVE|DROPEFFECT_COPY);
最后一點要注意的是,在Windows NT 4.0以上的系統(tǒng)中,即使實際產(chǎn)生的是DROPEFFECT_MOVE動作,DoDragDrop函數(shù)也只返回DROPEFFECT_NONE。產(chǎn)生這個問題的原因在于,Windows NT 4.0的Shell會直接移動文件本身來對移動操作進行優(yōu)化。返回值DROPEFFECT_MOVE最初的含義,就是通知執(zhí)行拖放操作的應用程序去刪除原位置上的文件。但是因為Shell已經(jīng)替應用程序完成了這個(刪除)動作,所以,函數(shù)返回DROPEFFECT_NONE。要想知道文件是否真的被移動了也很簡單,只要在函數(shù)返回之后檢查一下原位置上的文件是否存在就可以了。
Windows 9x系列的操作系統(tǒng)也會對移動進行同樣的優(yōu)化動作,但是它不會返回DROPEFFECT_NONE來代替DROPEFFECT_MOVE。詳細的解釋參見MS知識庫Q182219。
posted on 2008-08-14 19:19
幽幽 閱讀(3184)
評論(0) 編輯 收藏 引用 所屬分類:
Windows