IDataObjectImpl-Klasse
Diese Klasse bietet Methoden zur Unterstützung von Uniform Data Transfer und Verwalten von Verbindungen.
Wichtig
Diese Klasse und ihre Member können nicht in Anwendungen verwendet werden, die in der Windows-Runtime ausgeführt werden.
template<class T>
class IDataObjectImpl
T
Ihre Klasse, abgeleitet von IDataObjectImpl
.
Name | Beschreibung |
---|---|
IDataObjectImpl::D Advise | Stellt eine Verbindung zwischen dem Datenobjekt und einer Empfehlungsspüle her. Dadurch kann die Empfehlungssenke Benachrichtigungen über Änderungen im Objekt erhalten. |
IDataObjectImpl::D Unadvise | Beendet eine zuvor hergestellte Verbindung über DAdvise . |
IDataObjectImpl::EnumDAdvise | Erstellt einen Enumerator zum Durchlaufen der aktuellen Empfehlungsverbindungen. |
IDataObjectImpl::EnumFormatEtc | Erstellt einen Enumerator, um die FORMATETC vom Datenobjekt unterstützten Strukturen zu durchlaufen. Die ATL-Implementierung gibt E_NOTIMPL zurück. |
IDataObjectImpl::FireDataChange | Sendet eine Änderungsbenachrichtigung an jede Empfehlungsspüle zurück. |
IDataObjectImpl::GetCanonicalFormatEtc | Ruft eine logisch gleichwertige FORMATETC Struktur zu einer ab, die komplexer ist. Die ATL-Implementierung gibt E_NOTIMPL zurück. |
IDataObjectImpl::GetData | Überträgt Daten vom Datenobjekt an den Client. Die Daten werden in einer FORMATETC Struktur beschrieben und über eine STGMEDIUM Struktur übertragen. |
IDataObjectImpl::GetDataHere | Ähnlich wie GetData der Client muss die STGMEDIUM Struktur zuordnen. Die ATL-Implementierung gibt E_NOTIMPL zurück. |
IDataObjectImpl::QueryGetData | Bestimmt, ob das Datenobjekt eine bestimmte FORMATETC Struktur zum Übertragen von Daten unterstützt. Die ATL-Implementierung gibt E_NOTIMPL zurück. |
IDataObjectImpl::SetData | Überträgt Daten vom Client an das Datenobjekt. Die ATL-Implementierung gibt E_NOTIMPL zurück. |
Die IDataObject-Schnittstelle stellt Methoden zur Unterstützung der einheitlichen Datenübertragung bereit. IDataObject
verwendet die Standardformatstrukturen FORMATETC und STGMEDIUM zum Abrufen und Speichern von Daten.
IDataObject
verwaltet außerdem Verbindungen, um Senken zur Behandlung von Datenänderungsbenachrichtigungen zu empfehlen. Damit der Client Datenänderungsbenachrichtigungen vom Datenobjekt empfängt, muss der Client die IAdviseSink-Schnittstelle auf einem Objekt implementieren, das als Empfehlungsspüle bezeichnet wird. Wenn der Client dann aufruft IDataObject::DAdvise
, wird eine Verbindung zwischen dem Datenobjekt und der Empfehlungsspüle hergestellt.
Klasse IDataObjectImpl
bietet eine Standardimplementierung von IDataObject
und implementiert, indem Informationen in Debugbuilds IUnknown
an das Speicherabbildgerät gesendet werden.
Verwandte Artikel ATL-Lernprogramm, Erstellen eines ATL-Projekts
IDataObject
IDataObjectImpl
Header: atlctl.h
Stellt eine Verbindung zwischen dem Datenobjekt und einer Empfehlungsspüle her.
HRESULT DAdvise(
FORMATETC* pformatetc,
DWORD advf,
IAdviseSink* pAdvSink,
DWORD* pdwConnection);
Dadurch kann die Empfehlungssenke Benachrichtigungen über Änderungen im Objekt erhalten.
Rufen Sie zum Beenden der Verbindung DUnadvise auf.
Siehe "IDataObject::D Advise " im Windows SDK.
Beendet eine zuvor über DAdvise erstellte Verbindung.
HRESULT DUnadvise(DWORD dwConnection);
Siehe "IDataObject::D Unadvise " im Windows SDK.
Erstellt einen Enumerator zum Durchlaufen der aktuellen Empfehlungsverbindungen.
HRESULT DAdvise(
FORMATETC* pformatetc,
DWORD advf,
IAdviseSink* pAdvSink,
DWORD* pdwConnection);
Siehe "IDataObject::EnumDAdvise " im Windows SDK.
Erstellt einen Enumerator, um die FORMATETC
vom Datenobjekt unterstützten Strukturen zu durchlaufen.
HRESULT EnumFormatEtc(
DWORD dwDirection,
IEnumFORMATETC** ppenumFormatEtc);
Siehe "IDataObject::EnumFormatEtc " im Windows SDK.
Gibt E_NOTIMPL zurück.
Sendet eine Änderungsbenachrichtigung an jede Empfehlungssenke zurück, die derzeit verwaltet wird.
HRESULT FireDataChange();
Ein HRESULT-Standardwert.
Ruft eine logisch gleichwertige FORMATETC
Struktur zu einer ab, die komplexer ist.
HRESULT GetCanonicalFormatEtc(FORMATETC* pformatetcIn, FORMATETC* pformatetcOut);
Gibt E_NOTIMPL zurück.
Siehe "IDataObject::GetCanonicalFormatEtc " im Windows SDK.
Überträgt Daten vom Datenobjekt an den Client.
HRESULT GetData(
FORMATETC* pformatetcIn,
STGMEDIUM* pmedium);
Der Parameter "pformatetcIn " muss einen Speichermediumtyp von TYMED_MFPICT angeben.
Siehe "IDataObject::GetData " im Windows SDK.
Ähnlich wie GetData
der Client muss die STGMEDIUM
Struktur zuordnen.
HRESULT GetDataHere(
FORMATETC* pformatetc,
STGMEDIUM* pmedium);
Gibt E_NOTIMPL zurück.
Siehe "IDataObject::GetDataHere " im Windows SDK.
Bestimmt, ob das Datenobjekt eine bestimmte FORMATETC
Struktur zum Übertragen von Daten unterstützt.
HRESULT QueryGetData(FORMATETC* pformatetc);
Gibt E_NOTIMPL zurück.
Siehe "IDataObject::QueryGetData " im Windows SDK.
Überträgt Daten vom Client an das Datenobjekt.
HRESULT SetData(
FORMATETC* pformatetc,
STGMEDIUM* pmedium,
BOOL fRelease);
Gibt E_NOTIMPL zurück.
Siehe "IDataObject::SetData " im Windows SDK.