IDataObject Schnittstelle

Definition

Stellt die verwaltete Definition der IDataObject-Schnittstelle bereit.Provides the managed definition of the IDataObject interface.

public interface class IDataObject
[System.Runtime.InteropServices.Guid("0000010e-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.Guid("0000010E-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIUnknown)]
public interface IDataObject
type IDataObject = interface
Public Interface IDataObject
Abgeleitet
Attribute

Hinweise

Weitere Informationen IDataObject zur-Schnittstelle finden Sie in der MSDN Library.For more information about the IDataObject interface, see the MSDN Library.

Der Common Language Runtime löst eine Ausnahme aus, wenn eine com-Methode in nativem Code ein HRESULT zurückgibt.The common language runtime throws an exception when a COM method in native code returns an HRESULT. Weitere Informationen finden Sie unter How to: Map HRESULTs and Exceptions.For more information, see How to: Map HRESULTs and Exceptions.

Methoden

DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)

Erstellt eine Verbindung zwischen einem Datenobjekt und einer Advise-Senke.Creates a connection between a data object and an advisory sink. Diese Methode wird von einem Objekt aufgerufen, das eine Advise-Senke unterstützt, und aktiviert die Advise-Senke für den Empfang von Änderungsbenachrichtigungen für Daten des Objekts.This method is called by an object that supports an advisory sink and enables the advisory sink to be notified of changes in the object's data.

DUnadvise(Int32)

Zerstört eine Benachrichtigungsverbindung, die zuvor hergestellt wurde.Destroys a notification connection that had been previously established.

EnumDAdvise(IEnumSTATDATA)

Erstellt ein Objekt, mit dem die aktuellen Advise-Verbindungen aufgelistet werden können.Creates an object that can be used to enumerate the current advisory connections.

EnumFormatEtc(DATADIR)

Erstellt ein Objekt für das Auflisten der FORMATETC-Strukturen für ein Datenobjekt.Creates an object for enumerating the FORMATETC structures for a data object. Diese Strukturen werden in Aufrufen von GetData(FORMATETC, STGMEDIUM) oder SetData(FORMATETC, STGMEDIUM, Boolean) verwendet.These structures are used in calls to GetData(FORMATETC, STGMEDIUM) or SetData(FORMATETC, STGMEDIUM, Boolean).

GetCanonicalFormatEtc(FORMATETC, FORMATETC)

Stellt eine Standard-FORMATETC-Struktur bereit, die einer komplexeren Struktur logisch entspricht.Provides a standard FORMATETC structure that is logically equivalent to a more complex structure. Mit dieser Methode können Sie bestimmen, ob zwei unterschiedliche FORMATETC-Strukturen dieselben Daten zurückgeben würden. Dadurch müssen Sie nicht doppelt rendern.Use this method to determine whether two different FORMATETC structures would return the same data, removing the need for duplicate rendering.

GetData(FORMATETC, STGMEDIUM)

Ruft Daten aus einem Quelldatenobjekt ab.Obtains data from a source data object. Die von einem Datennutzer aufgerufene GetData(FORMATETC, STGMEDIUM)-Methode rendert die in der angegebenen FORMATETC-Struktur beschriebenen Daten und überträgt diese über die angegebene STGMEDIUM-Struktur.The GetData(FORMATETC, STGMEDIUM) method, which is called by a data consumer, renders the data described in the specified FORMATETC structure and transfers it through the specified STGMEDIUM structure. Der Aufrufer ist dann für das Freigeben der STGMEDIUM-Struktur verantwortlich.The caller then assumes responsibility for releasing the STGMEDIUM structure.

GetDataHere(FORMATETC, STGMEDIUM)

Ruft Daten aus einem Quelldatenobjekt ab.Obtains data from a source data object. Diese Methode, die von einem Datennutzer aufgerufen wird, unterscheidet sich von der GetData(FORMATETC, STGMEDIUM)-Methode dadurch, dass der Aufrufer das angegebene Speichermedium zuordnen und freigeben muss.This method, which is called by a data consumer, differs from the GetData(FORMATETC, STGMEDIUM) method in that the caller must allocate and free the specified storage medium.

QueryGetData(FORMATETC)

Bestimmt, ob das Datenobjekt die in der FORMATETC-Struktur beschriebenen Daten rendern kann.Determines whether the data object is capable of rendering the data described in the FORMATETC structure. Objekte, die einen Einfüge oder Ablagevorgang ausführen möchten, können diese Methode aufrufen, bevor sie GetData(FORMATETC, STGMEDIUM) aufrufen, um zu bestimmen, ob der Vorgang erfolgreich durchgeführt werden kann.Objects attempting a paste or drop operation can call this method before calling GetData(FORMATETC, STGMEDIUM) to get an indication of whether the operation may be successful.

SetData(FORMATETC, STGMEDIUM, Boolean)

Überträgt Daten an das Objekt, das diese Methode implementiert.Transfers data to the object that implements this method. Diese Methode wird von einem Objekt aufgerufen, das eine Datenquelle enthält.This method is called by an object that contains a data source.

Gilt für: