IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) Metoda

Definice

Obor názvů:

System.Runtime.InteropServices.ComTypes

Sestavení:

netstandard.dll, System.Runtime.InteropServices.dll

Zdroj:

IDataObject.cs

Poskytuje standardní FORMATETC strukturu, která je logicky ekvivalentní složitější struktuře. Tuto metodu použijte k určení, jestli by dvě různé FORMATETC struktury vrátily stejná data, a proto je potřeba duplikovat vykreslování.

public:
 int GetCanonicalFormatEtc(System::Runtime::InteropServices::ComTypes::FORMATETC % formatIn, [Runtime::InteropServices::Out] System::Runtime::InteropServices::ComTypes::FORMATETC % formatOut);

public int GetCanonicalFormatEtc(ref System.Runtime.InteropServices.ComTypes.FORMATETC formatIn, out System.Runtime.InteropServices.ComTypes.FORMATETC formatOut);

abstract member GetCanonicalFormatEtc : FORMATETC * FORMATETC -> int

Public Function GetCanonicalFormatEtc (ByRef formatIn As FORMATETC, ByRef formatOut As FORMATETC) As Integer

Parametry

formatIn

FORMATETC

Ukazatel na FORMATETC strukturu předanou odkazem, která definuje formát, střední a cílové zařízení, které volající chce použít k načtení dat v následném volání, například GetData(FORMATETC, STGMEDIUM). Člen TYMED v tomto případě není významný a měl by být ignorován.

formatOut

FORMATETC

Pokud tato metoda vrátí, obsahuje ukazatel na FORMATETC strukturu, která obsahuje nejobecnější informace možné pro konkrétní vykreslování, takže je kanonicky ekvivalentní formatetcIn. Volající musí přidělit tuto strukturu a GetCanonicalFormatEtc(FORMATETC, FORMATETC) metoda musí vyplnit data. K načtení dat v následném volání, jako GetData(FORMATETC, STGMEDIUM)je , volající používá zadanou hodnotu formatOut, pokud není nullzadaná hodnota . Tato hodnota je null , pokud metoda vrátí DATA_S_SAMEFORMATETC. Člen TYMED v tomto případě není významný a měl by být ignorován. Tento parametr se předává neinicializovaný.

Návraty

Int32

Tato metoda podporuje standardní návratové hodnoty E_INVALIDARG, E_UNEXPECTED a E_OUTOFMEMORY a také následující:

Hodnota	Popis
S_OK	FORMATETC Vrácená struktura se liší od té, která byla předána.
DATA_S_SAMEFORMATETC	Struktury FORMATETC jsou stejné a null vrátí se v parametru formatOut .
DV_E_LINDEX	Pro ; v současné době je lindexpodporována pouze -1.
DV_E_FORMATETC	Parametr má neplatnou hodnotu formatIn .
OLE_E_NOTRUNNING	Aplikace není spuštěná.

Poznámky

Další informace naleznete v tématu IDataObject::GetCanonicalFormatEtc metoda.