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

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

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

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

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

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

typedef struct

{

    CLIPFORMAT      cfFormat;   // 粘貼板格式 

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

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

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

    DWORD           tymed;       // 用于數(shù)據(jù)傳輸?shù)拇鎯γ襟w（HGLOBAL,IStream）

} FORMATETC;

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

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

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

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

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

Typemed：這是一個有趣的成員；因為其描述了用于存儲數(shù)據(jù)的存儲媒體類型。該成員名字自詞組“Type of Medium”；該值在window.h中定義的TYMED_XXX等值。

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

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

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

typedef struct 

{

    DWORD tymed;

    union

    {

        HBITMAP        hBitmap;

        HMETAFILEPICT  hMetaFilePict;

        HENHMETAFILE   hEnhMetaFile;

        HGLOBAL        hGlobal;

        LPWSTR         lpszFileName;

        IStream        *pstm;

        IStorage       *pstg;

    }; 

    IUnknown *pUnkForRelease;

} STGMEDIUM;

這個結(jié)構(gòu)定義看起來比較復(fù)雜，但是有用的僅僅三個成員，因為未命名聯(lián)合合并了所有內(nèi)容作為一個實體共享同樣的存儲空間。

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

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

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

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

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

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

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

下面的表列出了IDataObject成員函數(shù)，按照他們在接口虛表中出現(xiàn)的順序。為了簡化的原因，IUnknown方法（AddRef，Release和QueryInterface）沒有列出。

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

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

使用IDataObject來訪問粘貼板

為了使在我們的OLE旅程中放松一下，下面我們來看一個簡單的通過OLE來訪問粘貼板的例子：

WINOLEAPI OleGetClipboard(IDataObject ** ppDataObj);

這個簡單的Windows API調(diào)用用來返回一個IDataObject，它提供用來一個干凈地訪問WINDOWS粘貼板內(nèi)容的好接口。注意，我們在本例中不需要實現(xiàn)IDataObject接口，我們僅僅需要知道接口怎么樣工作的，一個簡單的訪問粘貼板內(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)用非常簡單，且它是直接來訪問IDataObject對象：

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句柄，因為我們不能確信這是否是一個GEM_FIXED數(shù)據(jù)

        char *data = GlobalLock(stgmed.hGlobal);

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

        // cleanup

        GlobalUnlock(stgmed.hGlobal);

        ReleaseStgMedium(&stgmed);

    }

}

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

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

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