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.

Syntax

template<class T>
class IDataObjectImpl

Parameter

T
Ihre Klasse, abgeleitet von IDataObjectImpl.

Member

Öffentliche Methoden

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 GetDatader 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.

Hinweise

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

Vererbungshierarchie

IDataObject

IDataObjectImpl

Anforderungen

Header: atlctl.h

IDataObjectImpl::D Advise

Stellt eine Verbindung zwischen dem Datenobjekt und einer Empfehlungsspüle her.

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

Hinweise

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.

IDataObjectImpl::D Unadvise

Beendet eine zuvor über DAdvise erstellte Verbindung.

HRESULT DUnadvise(DWORD dwConnection);

Hinweise

Siehe "IDataObject::D Unadvise " im Windows SDK.

IDataObjectImpl::EnumDAdvise

Erstellt einen Enumerator zum Durchlaufen der aktuellen Empfehlungsverbindungen.

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

Hinweise

Siehe "IDataObject::EnumDAdvise " im Windows SDK.

IDataObjectImpl::EnumFormatEtc

Erstellt einen Enumerator, um die FORMATETC vom Datenobjekt unterstützten Strukturen zu durchlaufen.

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

Hinweise

Siehe "IDataObject::EnumFormatEtc " im Windows SDK.

Rückgabewert

Gibt E_NOTIMPL zurück.

IDataObjectImpl::FireDataChange

Sendet eine Änderungsbenachrichtigung an jede Empfehlungssenke zurück, die derzeit verwaltet wird.

HRESULT FireDataChange();

Rückgabewert

Ein HRESULT-Standardwert.

IDataObjectImpl::GetCanonicalFormatEtc

Ruft eine logisch gleichwertige FORMATETC Struktur zu einer ab, die komplexer ist.

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

Rückgabewert

Gibt E_NOTIMPL zurück.

Hinweise

Siehe "IDataObject::GetCanonicalFormatEtc " im Windows SDK.

IDataObjectImpl::GetData

Überträgt Daten vom Datenobjekt an den Client.

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

Hinweise

Der Parameter "pformatetcIn " muss einen Speichermediumtyp von TYMED_MFPICT angeben.

Siehe "IDataObject::GetData " im Windows SDK.

IDataObjectImpl::GetDataHere

Ähnlich wie GetDatader Client muss die STGMEDIUM Struktur zuordnen.

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

Rückgabewert

Gibt E_NOTIMPL zurück.

Hinweise

Siehe "IDataObject::GetDataHere " im Windows SDK.

IDataObjectImpl::QueryGetData

Bestimmt, ob das Datenobjekt eine bestimmte FORMATETC Struktur zum Übertragen von Daten unterstützt.

HRESULT QueryGetData(FORMATETC* pformatetc);

Rückgabewert

Gibt E_NOTIMPL zurück.

Hinweise

Siehe "IDataObject::QueryGetData " im Windows SDK.

IDataObjectImpl::SetData

Überträgt Daten vom Client an das Datenobjekt.

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

Rückgabewert

Gibt E_NOTIMPL zurück.

Hinweise

Siehe "IDataObject::SetData " im Windows SDK.

Siehe auch

Klassenübersicht