歡迎來(lái)到OLE拖放旅程系列的第五部分，我們機(jī)會(huì)到了OLE拖放實(shí)現(xiàn)的最后階段，現(xiàn)在需要做的事情就是實(shí)現(xiàn)IDropSource和IDropTarget接口；一般我們完成這些，我們就可以在任何程序中添加拖放操作了。
本部分的目的在于實(shí)現(xiàn)一個(gè)用作拖放源的簡(jiǎn)單程序，它不能接收任何拖放的數(shù)據(jù)，但這不要緊，因?yàn)槲覀兡苁褂萌魏纹匠ＶС滞戏挪僮鞯?/SPAN>windows程序（例如：WordPad）來(lái)測(cè)試，程序就是一個(gè)windows的Edit控件，它是子類化的，且支持拖操作。
這個(gè)子類的細(xì)節(jié)在這里不討論，但源碼可以很清晰的說(shuō)明這個(gè)任務(wù)。
成為一個(gè)拖放的源對(duì)象
初始化一個(gè)拖放操作很簡(jiǎn)單，只要調(diào)用DoDragDrop這個(gè)API就足夠了。
WINOLEAPI DoDragDrop (
IDataObject * pDataObject,
IDropSource * pDropSource,
DWORD dwOKEffect,
DWORD * pdwEffect
);
一旦你調(diào)用這個(gè)AIP，OLE運(yùn)行時(shí)就代表你的程序來(lái)接管并處理所有必要的鼠標(biāo)和鍵盤windows消息，因此你基本上將控制權(quán)在調(diào)用這個(gè)函數(shù)的時(shí)候交給了OLE。
前兩個(gè)參數(shù)是COM接口，一個(gè)是IDataObject-我們前面已經(jīng)介紹了這個(gè)接口。
第三個(gè)參數(shù)是一個(gè)DWORD值，它表示源允許的拖動(dòng)效果，其以位掩碼的方式給出。這些效果是DROPEFFECT_XXX值，通常是DROPEFFECT_MOVE和DROPEFFECT_COPY的聯(lián)合。如果你想僅僅允許從我們的源復(fù)制數(shù)據(jù)，那么我們應(yīng)該就指定DROPEFFECT_COPY。
最后一個(gè)參數(shù)是指向DWORD的指針。該值在DoDragDrop返回的時(shí)候可以訪問(wèn)，包含OLE期望源對(duì)象執(zhí)行的效果和動(dòng)作，例如：用戶選擇移動(dòng)還是復(fù)制數(shù)據(jù)？
執(zhí)行拖放操作的代碼實(shí)際上分成三步：首先我們需要寫(xiě)一個(gè)小的功能函數(shù)叫做StringToHandle，它轉(zhuǎn)換一個(gè)char*字符為HGLOBAL，從而我們可以在OLE中使用：
HANDLE StringToHandle (char *szText, int nTextLen)
{ void *ptr;
if(nTextLen == -1)
nTextLen = lstrlen (szText) + 1;
ptr = (void *)GlobalAlloc(GMEM_FIXED, nTextLen);
memcpy (ptr, szText, nTextLen);
return ptr;
}
StringToHandle完全不執(zhí)行錯(cuò)誤簡(jiǎn)單，因此這是你的責(zé)任；下一步是準(zhǔn)備拖放操作使用的數(shù)據(jù)：
FORMATETC fmtetc =
{ CF_TEXT,
0,
DVASPECT_CONTENT,
-1,
TYMED_HGLOBAL
};
STGMEDIUM stgmed =
{ TYMED_HGLOBAL,
{0}, 0
};
stgmed.hGlobal = StringToHandle ("Hello, World", -1);緊接著就是創(chuàng)建兩個(gè)拖放操作的COM接口：IDropSource和IDataObject。我們?cè)谇懊娴穆贸讨袑?shí)現(xiàn)了CreateDataObject，馬上會(huì)實(shí)現(xiàn)CreateDropSource：
IDropSource *pDropSource;
IDataObject *pDataObject;
CreateDropSource (&pDropSource);
CreateDataObject (&pDataObject, &fmtetc, &stgmed, 1);
在創(chuàng)建好IDataObject和IDropSource之后就可以調(diào)用DoDragDrop了：
DWORD dwResult;
dwResult = DoDragDrop(pDataObject, pDropSource, DROPEFFECT_COPY, &dwEffect);
if(dwResult == DRAGDROP_S_DROP)
{ if(dwEffect == DROPEFFECT_MOVE)
{
}
}
最后一件事情就是清除所有我們使用過(guò)的資源，首先刪除我們使用的兩個(gè)COM接口，然后刪除包含我們文本的HGLOBAL內(nèi)存緩沖區(qū)。
pDropSource->Release();
pDataObject->Release();
ReleaseStgMedium(&stgmed);
什么時(shí)候調(diào)用DoDragDrop方法來(lái)
知道了怎么樣初始化拖放操作非常好，但真正重要的是理解將上面的代碼放到你程序的什么位置？
因?yàn)橥戏挪僮魇腔谑髽?biāo)的，它通常在處理windows鼠標(biāo)消息的時(shí)候被初始化，如果你在支持拖放操作的程序中測(cè)試（例如WordPad），你會(huì)觀察到RichEdit控件有下面的行為：
1. 當(dāng)鼠標(biāo)移動(dòng)過(guò)選中的文本，它的光標(biāo)形狀變成箭頭
2. 當(dāng)按下左鍵的時(shí)候，被選擇的不會(huì)被刪除，且設(shè)置內(nèi)部狀態(tài)來(lái)指示可能要開(kāi)始拖放操作
3. 當(dāng)鼠標(biāo)被第一次移動(dòng)（并且內(nèi)部狀態(tài)指示左鍵一直按在被選中的文本區(qū)域中），拖動(dòng)操作開(kāi)始。
4. 在這個(gè)時(shí)候，OLE接管并處理所有鼠標(biāo)消息，直到操作完成
5. 然而，如果左鍵被釋放了，或者鼠標(biāo)根本沒(méi)有移動(dòng)，RichEdit選擇部分被清除。
這些行為在C或C++中實(shí)現(xiàn)非常簡(jiǎn)單，對(duì)于我們的子類化的控件，可能是這樣：
case WM_LBUTTONDOWN:
if(MouseInSelection(hwndEdit))
{ fMouseDown = TRUE;
return 0;
}
break;
case WM_MOUSEMOUVE:
if(fMouseDown == TRUE)
{ DoDragDrop (...);
}
fMouseDown = FALSE;
break;
case WM_LBUTTONUP:
fMouseDown = FALSE;
break;
IDropSource接口
IDropSource是拖放操作中最簡(jiǎn)單的接口，除了IUnknown函數(shù)外，它僅僅包含兩個(gè)需要實(shí)現(xiàn)的函數(shù)：
|
IDropSource 方法 |
描述 |
|
QueryContinueDrag |
決定是否應(yīng)該繼續(xù)、取消或完成一個(gè)拖放操作，基于鼠標(biāo)和<Escape>、 <Control> 和 <Shift> 鍵的狀態(tài)。 |
|
GiveFeedback |
為拖放操作的源提供一個(gè)用來(lái)給出可視化效果的方法，基于鼠標(biāo)鍵、escape、control等鍵的狀態(tài)。 |
兩個(gè)函數(shù)由COM/OLE運(yùn)行時(shí)在拖放操作的修飾鍵狀態(tài)改變的時(shí)候調(diào)用，需要做的工作就是實(shí)現(xiàn)這個(gè)接口-實(shí)際上，在準(zhǔn)備拖放的時(shí)候已經(jīng)做了很多編碼了。
實(shí)現(xiàn)IDropSource
同樣我們用一個(gè)源文件來(lái)實(shí)現(xiàn)drop源。在dropsource.cpp中是類的定義，下面就是這些代碼：
class CDropSource : public IDropSource
{public:
HRESULT __stdcall QueryInterface (REFIID iid, void ** ppvObject);
ULONG __stdcall AddRef (void);
ULONG __stdcall Release (void);
HRESULT __stdcall QueryContinueDrag (BOOL fEscapePressed, DWORD grfKeyState);
HRESULT __stdcall GiveFeedback (DWORD dwEffect);
CDropSource();
~CDropSource();
private:
LONG m_lRefCount;
};
該類的構(gòu)造函數(shù)除了執(zhí)行初始化對(duì)象引用記數(shù)的操作外不執(zhí)行任何其他的工作。
IDropSource::QueryContinueDrag
下面是QueryContinueDrag函數(shù)的定義：
HRESULT QueryContinueDrag(
BOOL fEscapePressed,
DWORD grfKeyState,
);
函數(shù)返回三個(gè)值的一個(gè)：
1． S_OK，拖動(dòng)操作應(yīng)該繼續(xù)；如果沒(méi)有檢查到錯(cuò)誤就是這個(gè)結(jié)果，開(kāi)始拖放操作的鼠標(biāo)沒(méi)有被釋放，也沒(méi)有ESC鍵
2． DRAGDROP_S_DROP，放操作發(fā)生來(lái)完成拖操作；如果grfKeyState指出啟動(dòng)拖放操作的鍵松開(kāi)了就會(huì)發(fā)生這個(gè)結(jié)果。
3． DRAGDROP_S_CANCEL；沒(méi)有放操作發(fā)生時(shí)拖操作被放棄，這是fEscapePressed是真的表示ESC鍵被按下的結(jié)果。
作為COM的習(xí)慣，下面的兩個(gè)行為在拖放操作中應(yīng)該遵守：
1． 按下Escape鍵時(shí)取消拖放操作
2． 松開(kāi)鼠標(biāo)左鍵的時(shí)候，應(yīng)該執(zhí)行放操作
為了符合這些規(guī)則，QueryContinueDrag如下實(shí)現(xiàn)：
HRESULT __stdcall CDropSource::QueryContinueDrag(BOOL fEscapePressed, DWORD grfKeyState)
{
if(fEscapePressed == TRUE)
return DRAGDROP_S_CANCEL;
if((grfKeyState & MK_LBUTTON) == 0)
return DRAGDROP_S_DROP;
return S_OK;
}
IDropSource::GiveFeedback
這個(gè)函數(shù)通常在每個(gè)程序中都不同，因?yàn)闆](méi)有一個(gè)程序是相同的。然而除非我們提供一個(gè)圖形反饋效果，否則我們的是很簡(jiǎn)單：
HRESULT __stdcall CDropSource::GiveFeedback (DWORD dwEffect)
{
return DRAGDROP_S_USEDEFAULTCURSORS;
}
參數(shù)dwEffect（它告訴我們哪個(gè)鼠標(biāo)鍵被按下，哪個(gè)鍵盤修飾在使用）在許多拖放操作程序中都可以忽略，簡(jiǎn)單的DRAGDROP_S_USEDEFAULTCURSORS來(lái)告訴COM在發(fā)生任何修飾符改變的時(shí)候更新鼠標(biāo)光標(biāo)。
當(dāng)然，我們可以檢查dwEffect的DROPEFFECT_XXX標(biāo)志來(lái)PAINT我們的源窗口并返回S_OK，但為什么要這么麻煩來(lái)？