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.