第二部分：OLE數(shù)據(jù)傳輸(OLE Drag和Drop隨筆)

歡迎來(lái)到OLE拖放指南第二部分；本部分的目的在于解釋在OLE環(huán)境中，程序之間怎么樣表示和傳輸數(shù)據(jù)。

OLE數(shù)據(jù)傳輸?shù)暮诵氖?/SPAN>IDataObject COM接口，一個(gè)IDataObject提供從一個(gè)程序到另一個(gè)程序傳輸和訪問(wèn)數(shù)據(jù)的方法。最通用的OLE數(shù)據(jù)傳輸是窗口粘貼板，當(dāng)然也有拖放。IDataObject是一到多個(gè)數(shù)據(jù)的有效的COM包裝。

在我們調(diào)查IDataObject任何細(xì)節(jié)之前，兩個(gè)重要的數(shù)據(jù)結(jié)構(gòu)你必須熟悉：FORMATETC和STGMEDIUM接口，他們用來(lái)描述和存儲(chǔ)OLE數(shù)據(jù)。

描述OLE數(shù)據(jù)

FORMATETC接口（發(fā)音“format et cetera”）用來(lái)表示IDataObject提供（或接收）的數(shù)據(jù)類型，是標(biāo)準(zhǔn)window粘貼板格式（CF_TEXT等）的擴(kuò)展，因此除了基本的粘貼板格式之外，還包含了數(shù)據(jù)怎么樣rendered和存儲(chǔ)。

typedef struct

{

    CLIPFORMAT      cfFormat;   // 粘貼板格式 

    DVTARGETDEVICE *ptd;        // (NULL)  rendering的目標(biāo)設(shè)備

    DWORD           dwAspect;    // (DV_CONTENT) rendering的詳細(xì)程度

    LONG            lindex;      // (-1)  在數(shù)據(jù)通過(guò)頁(yè)面邊界分割的時(shí)候使用

    DWORD           tymed;       // 用于數(shù)據(jù)傳輸?shù)拇鎯?chǔ)媒體（HGLOBAL,IStream）

} FORMATETC;

FORMATETC結(jié)構(gòu)的成員如下描述：

cfFormat：粘貼板格式，用來(lái)表示FORMATETC結(jié)構(gòu)。可以是內(nèi)建的格式（例如：CF_TEXT或CF_BITMAP）或者用RegisterClipboardFormat注冊(cè)的自定義格式。

Ptd:指向DVTARGETDEVICE結(jié)構(gòu)，提供已經(jīng)rendered數(shù)據(jù)的設(shè)備信息。正常的粘貼板操作和拖放操作都是NULL。

dwAspect：描述用戶怎么樣render數(shù)據(jù)的大量細(xì)節(jié)。通常這個(gè)是DVASPECT_CONTECT，表示全內(nèi)容，但也可以描述較少的信息，例如：圖標(biāo)。

Lindex：僅僅在當(dāng)數(shù)據(jù)通過(guò)頁(yè)面邊界被分割的時(shí)候使用，它不用于簡(jiǎn)單的OLE傳輸，因此該值幾乎總是-1。

Typemed：這是一個(gè)有趣的成員；因?yàn)槠涿枋隽擞糜诖鎯?chǔ)數(shù)據(jù)的存儲(chǔ)媒體類型。該成員名字自詞組“Type of Medium”；該值在window.h中定義的TYMED_XXX等值。

因此有了這個(gè)數(shù)據(jù)結(jié)構(gòu)，OLE已經(jīng)提供了一個(gè)描述消費(fèi)者什么樣的數(shù)據(jù)已經(jīng)怎么樣render這個(gè)數(shù)據(jù)。

存儲(chǔ)OLE數(shù)據(jù)

結(jié)構(gòu)體STGMEDIUM(STORAGE MEDIUM的縮寫(xiě))提供一個(gè)用來(lái)存儲(chǔ)數(shù)據(jù)的容器，因此叫存儲(chǔ)媒體：

typedef struct 

{

    DWORD tymed;

    union

    {

        HBITMAP        hBitmap;

        HMETAFILEPICT  hMetaFilePict;

        HENHMETAFILE   hEnhMetaFile;

        HGLOBAL        hGlobal;

        LPWSTR         lpszFileName;

        IStream        *pstm;

        IStorage       *pstg;

    }; 

    IUnknown *pUnkForRelease;

} STGMEDIUM;

這個(gè)結(jié)構(gòu)定義看起來(lái)比較復(fù)雜，但是有用的僅僅三個(gè)成員，因?yàn)槲疵?lián)合合并了所有內(nèi)容作為一個(gè)實(shí)體共享同樣的存儲(chǔ)空間。

1.         tymed：這個(gè)成員必須和FORMATETC結(jié)構(gòu)相同，這個(gè)成員指定已經(jīng)存儲(chǔ)的媒體類型，例如，全局?jǐn)?shù)據(jù)（TYMED_HGLOBAL），IStream（TYPED_ISTREAM）等等。相應(yīng)的聯(lián)合中的元素是數(shù)據(jù)的句柄。

2.         hBitmap/hGlobal等：實(shí)際的數(shù)據(jù)，僅僅他們中的一個(gè)是有效的，這依賴于tymed的值。

3.         pUnkForRelease：一個(gè)可選的指針，指向IUnknown接口，數(shù)據(jù)的接收方應(yīng)該調(diào)用其Release方法。當(dāng)這個(gè)字段是NULL時(shí)，接收方有責(zé)任釋放內(nèi)存句柄。ReleaseStgMedium API調(diào)用在這里非常有用，它負(fù)責(zé)釋放STGMEDIUMS的數(shù)據(jù)內(nèi)容，因此實(shí)際上我們不需要做什么。

STGMEDIUM結(jié)構(gòu)是傳統(tǒng)的windows HGLOBAL內(nèi)存句柄的擴(kuò)展，同時(shí)支持HGLOBAL（且一直是最常用的），同時(shí)支持許多其他的類型，最有用的是IStream和IStorage通用COM接口。

總之，結(jié)構(gòu)體FORMATETC和STGMEDIUM一起用來(lái)描述和存儲(chǔ)OLE數(shù)據(jù)實(shí)體的。FORMATETC通常用來(lái)從IDataObject請(qǐng)求指定類型的數(shù)據(jù)，同時(shí)STGMEDIUM結(jié)構(gòu)用來(lái)接收和保存請(qǐng)求的數(shù)據(jù)。

傳輸OLE數(shù)據(jù)

IDataObject接口提供了從一個(gè)程序到另一個(gè)程序傳遞數(shù)據(jù)的方法，IDataObject在兩個(gè)情況下非常有用：粘貼板和拖放。如果設(shè)計(jì)精細(xì)，可以用一個(gè)COM對(duì)象來(lái)同時(shí)實(shí)現(xiàn)粘貼板和拖放操作。

下面的表列出了IDataObject成員函數(shù)，按照他們?cè)诮涌谔摫碇谐霈F(xiàn)的順序。為了簡(jiǎn)化的原因，IUnknown方法（AddRef，Release和QueryInterface）沒(méi)有列出。

這個(gè)表看起來(lái)很漂亮，我們也看到EnumFormatEtc方法并發(fā)現(xiàn)我們不得不同時(shí)實(shí)現(xiàn)IEnumFORMATETC接口，它有13個(gè)成員函數(shù)，不包括IUnknown方法，到這里我們還沒(méi)有考慮IDropSource和IDropTarget。

慶幸的是，為了簡(jiǎn)化OLE拖放，我們僅僅需要實(shí)現(xiàn)GetData、QueryGetData和EnumFormatEtc，因此這節(jié)省了我們?cè)S多工作。

使用IDataObject來(lái)訪問(wèn)粘貼板

為了使在我們的OLE旅程中放松一下，下面我們來(lái)看一個(gè)簡(jiǎn)單的通過(guò)OLE來(lái)訪問(wèn)粘貼板的例子：

WINOLEAPI OleGetClipboard(IDataObject ** ppDataObj);

這個(gè)簡(jiǎn)單的Windows API調(diào)用用來(lái)返回一個(gè)IDataObject，它提供用來(lái)一個(gè)干凈地訪問(wèn)WINDOWS粘貼板內(nèi)容的好接口。注意，我們?cè)诒纠胁恍枰獙?shí)現(xiàn)IDataObject接口，我們僅僅需要知道接口怎么樣工作的，一個(gè)簡(jiǎn)單的訪問(wèn)粘貼板內(nèi)容的程序如下：

#include <windows.h>

int main(void)

{

    IDataObject *pDataObject;

    // Initialize COM and OLE

    if(OleInitialize(0) != S_OK)

        return 0;

    // Access the data on the clipboard

    if(OleGetClipboard(&pDataObject) == S_OK)

    {

        // access the IDataObject using a separate function

        DisplayDataObject (pDataObject);

        pDataObject->Release();

    }

    // Cleanup

    OleUninitialize();

    return 0;

}

OLE API調(diào)用非常簡(jiǎn)單，且它是直接來(lái)訪問(wèn)IDataObject對(duì)象：

void DisplayDataObject(IDataObject *pDataObject)

{

    FORMATETC fmtetc = { CF_TEXT, 0, DVASPECT_CONTENT, -1, TYMED_HGLOBAL };

    STGMEDIUM stgmed;

    // ask the IDataObject for some CF_TEXT data, stored as a HGLOBAL

    if(pDataObject->GetData(&fmtetc, &stgmed) == S_OK)

    {

        // 我們必須鎖定HGLOBAL句柄，因?yàn)槲覀儾荒艽_信這是否是一個(gè)GEM_FIXED數(shù)據(jù)

        char *data = GlobalLock(stgmed.hGlobal);

        printf("%s\n", data);

        // cleanup

        GlobalUnlock(stgmed.hGlobal);

        ReleaseStgMedium(&stgmed);

    }

}

上面的代碼演示了最常用的訪問(wèn)IDataObject的方法，數(shù)據(jù)通過(guò)調(diào)用IDataObject::GetData來(lái)請(qǐng)求，我們構(gòu)造一個(gè)FORMATETC對(duì)象，它指定了我們想要訪問(wèn)的數(shù)據(jù)的類型，在這個(gè)例子中，標(biāo)準(zhǔn)的CF_TEXT數(shù)據(jù)緩沖區(qū)以HGLOBAL內(nèi)存對(duì)象來(lái)存儲(chǔ)。

數(shù)據(jù)返回到我們提供的STGMEDIUM結(jié)構(gòu)體中，一旦我們鎖定并顯示數(shù)據(jù)，清理和調(diào)用標(biāo)準(zhǔn)的ReleaseStgMedium API來(lái)釋放存儲(chǔ)在STGMEDIUM結(jié)構(gòu)中的數(shù)據(jù)就簡(jiǎn)單了。

posted on 2006-03-01 15:47 笨笨 閱讀(4484) 評(píng)論(2)  編輯 收藏 引用 所屬分類: OLE Drag&Drop