IDataObjectImpl – třída

Tato třída poskytuje metody pro podporu jednotného přenosu dat a správu připojení.

Důležité

Tuto třídu a její členy nelze použít v aplikacích, které se spouští v prostředí Windows Runtime.

Syntaxe

template<class T>
class IDataObjectImpl

Parametry

T
Vaše třída odvozená z IDataObjectImpl.

Členové

Veřejné metody

Název	Popis
IDataObjectImpl::D Advise	Vytvoří propojení mezi datovým objektem a jímkou pro rady. To umožňuje jímce, aby dostávala oznámení o změnách v objektu.
IDataObjectImpl::D Unadvise	Ukončí připojení, které bylo dříve vytvořeno prostřednictvím DAdvise.
IDataObjectImpl::EnumDAdvise	Vytvoří enumerátor pro iteraci prostřednictvím aktuálních připojení poradce.
IDataObjectImpl::EnumFormatEtc	Vytvoří enumerátor, který bude iterovat strukturami FORMATETC podporovanými datovým objektem. Implementace ATL vrátí E_NOTIMPL.
IDataObjectImpl::FireDataChange	Odešle oznámení o změně zpět do každé jímky s doporučeními.
IDataObjectImpl::GetCanonicalFormatEtc	Načte logicky ekvivalentní FORMATETC strukturu, která je složitější. Implementace ATL vrátí E_NOTIMPL.
IDataObjectImpl::GetData	Přenáší data z datového objektu do klienta. Data jsou popsána ve FORMATETC struktuře a přenášejí se prostřednictvím STGMEDIUM struktury.
IDataObjectImpl::GetDataHere	GetDataPodobně jako v případě , s výjimkou klienta musí přidělit STGMEDIUM strukturu. Implementace ATL vrátí E_NOTIMPL.
IDataObjectImpl::QueryGetData	Určuje, zda datový objekt podporuje konkrétní FORMATETC strukturu pro přenos dat. Implementace ATL vrátí E_NOTIMPL.
IDataObjectImpl::SetData	Přenáší data z klienta do datového objektu. Implementace ATL vrátí E_NOTIMPL.

Poznámky

Rozhraní IDataObject poskytuje metody pro podporu jednotného přenosu dat. IDataObject používá standardní struktury formátu FORMATETC a STGMEDIUM k načtení a ukládání dat.

IDataObject také spravuje připojení, která radí jímce pro zpracování oznámení o změnách dat. Aby klient mohl přijímat oznámení o změnách dat z datového objektu, musí klient implementovat rozhraní IAdviseSink na objekt označovaný jako jímka rady. Když klient potom zavolá IDataObject::DAdvise, vytvoří se připojení mezi datovým objektem a jímkou rady.

Třída IDataObjectImpl poskytuje výchozí implementaci IDataObject a implementuje IUnknown odesláním informací do zařízení s výpisem paměti v buildech ladění.

Související články ATL – kurz, vytvoření projektu ATL

Hierarchie dědičnosti

IDataObject

IDataObjectImpl

Požadavky

Hlavička: atlctl.h

IDataObjectImpl::D Advise

Vytvoří propojení mezi datovým objektem a jímkou pro rady.

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

Poznámky

To umožňuje jímce, aby dostávala oznámení o změnách v objektu.

Pokud chcete připojení ukončit, zavolejte DUnadvise.

Viz IDataObject::D Advise v sadě Windows SDK.

IDataObjectImpl::D Unadvise

Ukončí připojení dříve vytvořené prostřednictvím DAdvise.

HRESULT DUnadvise(DWORD dwConnection);

Poznámky

Viz IDataObject::D Unadvise v sadě Windows SDK.

IDataObjectImpl::EnumDAdvise

Vytvoří enumerátor pro iteraci prostřednictvím aktuálních připojení poradce.

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

Poznámky

Viz IDataObject::EnumDAdvise v sadě Windows SDK.

IDataObjectImpl::EnumFormatEtc

Vytvoří enumerátor, který bude iterovat strukturami FORMATETC podporovanými datovým objektem.

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

Poznámky

Viz IDataObject::EnumFormatEtc v sadě Windows SDK.

Návratová hodnota

Vrátí E_NOTIMPL.

IDataObjectImpl::FireDataChange

Odešle oznámení o změnách zpět do každé jímky, která se právě spravuje.

HRESULT FireDataChange();

Návratová hodnota

Standardní hodnota HRESULT.

IDataObjectImpl::GetCanonicalFormatEtc

Načte logicky ekvivalentní FORMATETC strukturu, která je složitější.

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

Návratová hodnota

Vrátí E_NOTIMPL.

Poznámky

Viz IDataObject::GetCanonicalFormatEtc v sadě Windows SDK.

IDataObjectImpl::GetData

Přenáší data z datového objektu do klienta.

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

Poznámky

Parametr pformatetcIn musí zadat typ média úložiště TYMED_MFPICT.

Viz IDataObject::GetData v sadě Windows SDK.

IDataObjectImpl::GetDataHere

GetDataPodobně jako v případě , s výjimkou klienta musí přidělit STGMEDIUM strukturu.

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

Návratová hodnota

Vrátí E_NOTIMPL.

Poznámky

Viz IDataObject::GetDataHere v sadě Windows SDK.

IDataObjectImpl::QueryGetData

Určuje, zda datový objekt podporuje konkrétní FORMATETC strukturu pro přenos dat.

HRESULT QueryGetData(FORMATETC* pformatetc);

Návratová hodnota

Vrátí E_NOTIMPL.

Poznámky

Viz IDataObject::QueryGetData v sadě Windows SDK.

IDataObjectImpl::SetData

Přenáší data z klienta do datového objektu.

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

Návratová hodnota

Vrátí E_NOTIMPL.

Poznámky

Viz IDataObject::SetData v sadě Windows SDK.

Viz také

Přehled třídy