DataObject.IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt eine Standard-FORMATETC-Struktur bereit, die einer komplexeren Struktur logisch entspricht. 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.

 virtual int System.Runtime.InteropServices.ComTypes.IDataObject.GetCanonicalFormatEtc(System::Runtime::InteropServices::ComTypes::FORMATETC % pformatetcIn, [Runtime::InteropServices::Out] System::Runtime::InteropServices::ComTypes::FORMATETC % pformatetcOut) = System::Runtime::InteropServices::ComTypes::IDataObject::GetCanonicalFormatEtc;

int IDataObject.GetCanonicalFormatEtc (ref System.Runtime.InteropServices.ComTypes.FORMATETC pformatetcIn, out System.Runtime.InteropServices.ComTypes.FORMATETC pformatetcOut);

abstract member System.Runtime.InteropServices.ComTypes.IDataObject.GetCanonicalFormatEtc : FORMATETC * FORMATETC -> int
override this.System.Runtime.InteropServices.ComTypes.IDataObject.GetCanonicalFormatEtc : FORMATETC * FORMATETC -> int

Function GetCanonicalFormatEtc (ByRef pformatetcIn As FORMATETC, ByRef pformatetcOut As FORMATETC) As Integer Implements IDataObject.GetCanonicalFormatEtc

Parameter

pformatetcIn: FORMATETC

Ein Zeiger auf eine FORMATETC-Struktur, der als Verweis übergeben wird und das Format, das Medium und das Zielgerät definiert, mit denen der Aufrufer Daten in einen späteren Aufruf abrufen möchte, z. B. GetData(FORMATETC, STGMEDIUM). Der TYMED-Member hat in diesem Fall keine Bedeutung und sollte ignoriert werden.

pformatetcOut: FORMATETC

Enthält nach dem Beenden dieser Methode einen Zeiger auf eine FORMATETC-Struktur, die sehr allgemeine Informationen für ein bestimmtes Rendering enthält, wodurch sie kanonisch äquivalent zu formatetcIn ist. Der Aufrufer muss diese Struktur zuordnen, und die GetCanonicalFormatEtc(FORMATETC, FORMATETC)-Methode muss die Daten ausfüllen. Zum Abrufen der Daten in einem späteren Aufruf wie GetData(FORMATETC, STGMEDIUM) verwendet der Aufrufer den von formatOut bereitgestellten Wert, sofern dieser nicht null ist. Dieser Wert ist null, wenn die Methode DATA_S_SAMEFORMATETC zurückgibt. Der TYMED-Member hat in diesem Fall keine Bedeutung und sollte ignoriert werden. Dieser Parameter wird nicht initialisiert übergeben.

Gibt zurück

Int32

Diese Methode unterstützt die Standardrückgabewerte E_INVALIDARG, E_UNEXPECTED und E_OUTOFMEMORY sowie die folgenden Werte:

Wert	BESCHREIBUNG
S_OK	Die zurückgegebene FORMATETC-Struktur unterscheidet sich von der übergebenen Struktur.
DATA_S_SAMEFORMATETC	Die FORMATETC-Strukturen sind identisch, und im `formatOut`-Parameter wird `null` zurückgegeben.
DV_E_LINDEX	Ein Wert für lindex ist ungültig. Derzeit wird nur -1 unterstützt.
DV_E_FORMATETC	Ein Wert für den `pFormatetc`-Parameter ist ungültig.
OLE_E_NOTRUNNING	Die Anwendung wird nicht ausgeführt.

Implementiert

GetCanonicalFormatEtc(FORMATETC, FORMATETC)

Hinweise

Bei diesem Member handelt es sich um eine explizite Schnittstellenmemberimplementierung. Er kann nur verwendet werden, wenn das DataObject in eine IDataObject-Schnittstelle umgewandelt wird.

Gilt für: