IDataObjectImpl Class

 

如需 Visual Studio 2017 的最新文件請參閱 Visual Studio 2017 文件

這個類別提供支援制式資料傳輸和管理連線的方法。

System_CAPS_ICON_important.jpg 重要

這個類別及其成員無法在 Windows 執行階段中執行的應用程式內使用。

template<class T>  
class IDataObjectImpl

參數

T
您的類別,衍生自IDataObjectImpl

公用方法

名稱說明
IDataObjectImpl::DAdvise建立資料物件和通知接收之間的連線。 這可讓通知接收變更通知的物件中。
IDataObjectImpl::DUnadvise終止透過先前建立的連線DAdvise
IDataObjectImpl::EnumDAdvise建立列舉值,可逐一查看目前諮詢連接。
IDataObjectImpl::EnumFormatEtc建立列舉值,可逐一查看FORMATETC資料物件支援的結構。 ATL 實作會傳回E_NOTIMPL
IDataObjectImpl::FireDataChange將變更通知傳回給每一個通知接收。
IDataObjectImpl::GetCanonicalFormatEtc擷取邏輯上等同FORMATETC為更複雜的結構。 ATL 實作會傳回E_NOTIMPL
IDataObjectImpl::GetData從資料物件的資料傳輸至用戶端。 資料描述在FORMATETC結構,並透過傳送STGMEDIUM結構。
IDataObjectImpl::GetDataHere類似於GetData,但用戶端必須配置STGMEDIUM結構。 ATL 實作會傳回E_NOTIMPL
IDataObjectImpl::QueryGetData判斷資料物件是否支援特定FORMATETC傳送資料的結構。 ATL 實作會傳回E_NOTIMPL
IDataObjectImpl::SetData將資料從用戶端傳輸至資料物件。 ATL 實作會傳回E_NOTIMPL

IDataObject介面提供方法來支援制式資料傳輸。 IDataObject使用標準格式結構FORMATETCSTGMEDIUM來擷取及儲存資料。

IDataObject也會管理連接到通知來處理資料變更通知的接收。 為了讓用戶端收到資料變更通知,從資料物件,用戶端必須實作IAdviseSink稱為通知接收的物件上的介面。 當用戶端接著呼叫IDataObject::DAdvise,資料物件和通知接收之間建立連線。

類別IDataObjectImpl提供的預設實作IDataObject並實作IUnknown傳送資訊給傾印裝置在偵錯組建。

相關文章 ATL 教學課程建立 ATL 專案

IDataObject

IDataObjectImpl

標頭︰ atlctl.h

建立資料物件和通知接收之間的連線。

HRESULT DAdvise(
    FORMATETC* pformatetc,
    DWORD advf,
    IAdviseSink* pAdvSink,
    DWORD* pdwConnection);

備註

這可讓通知接收變更通知的物件中。

若要終止的連接,呼叫DUnadvise

請參閱IDataObject::DAdvise中Windows SDK。

終止透過先前建立的連線DAdvise

HRESULT DUnadvise(DWORD dwConnection);

備註

請參閱IDataObject::DUnadvise中Windows SDK。

建立列舉值,可逐一查看目前諮詢連接。

HRESULT DAdvise(
    FORMATETC* pformatetc,
    DWORD advf,
    IAdviseSink* pAdvSink,
    DWORD* pdwConnection);

備註

請參閱IDataObject::EnumDAdvise中Windows SDK。

建立列舉值,可逐一查看FORMATETC資料物件支援的結構。

HRESULT EnumFormatEtc(  
    DWORD dwDirection,
    IEnumFORMATETC** ppenumFormatEtc);

備註

請參閱IDataObject::EnumFormatEtc中Windows SDK。

傳回值

傳回E_NOTIMPL

將變更通知傳回給目前未受管理的每個通知接收。

HRESULT FireDataChange();

傳回值

標準 HRESULT 值。

擷取邏輯上等同FORMATETC為更複雜的結構。

HRESULT GetCanonicalFormatEtc(FORMATETC* pformatetcIn, FORMATETC* pformatetcOut);

傳回值

傳回E_NOTIMPL

備註

請參閱IDataObject::GetCanonicalFormatEtc中Windows SDK。

從資料物件的資料傳輸至用戶端。

HRESULT GetData(
    FORMATETC* pformatetcIn,
    STGMEDIUM* pmedium);

備註

PformatetcIn參數必須指定的儲存媒體類型TYMED_MFPICT

請參閱idataobject:: Getdata中Windows SDK。

類似於GetData,但用戶端必須配置STGMEDIUM結構。

HRESULT GetDataHere(
    FORMATETC* pformatetc,
    STGMEDIUM* pmedium);

傳回值

傳回E_NOTIMPL

備註

請參閱IDataObject::GetDataHere中Windows SDK。

判斷資料物件是否支援特定FORMATETC傳送資料的結構。

HRESULT QueryGetData(FORMATETC* pformatetc);

傳回值

傳回E_NOTIMPL

備註

請參閱IDataObject::QueryGetData中Windows SDK。

將資料從用戶端傳輸至資料物件。

HRESULT SetData(
    FORMATETC* pformatetc,
    STGMEDIUM* pmedium,
    BOOL fRelease);

傳回值

傳回E_NOTIMPL

備註

請參閱IDataObject::SetData中Windows SDK。

類別概觀

顯示: