DataObject.IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) Metoda

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

 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

Parametry

pformatetcIn: FORMATETC

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

pformatetcOut: FORMATETC

Když tato metoda vrátí, obsahuje ukazatel na FORMATETC strukturu, která obsahuje nejobecnější možné informace pro konkrétní vykreslování, takže je kanonicky ekvivalentní k 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 , použije volající zadanou hodnotu formatOut, pokud zadaná hodnota není null. Tato hodnota je null , pokud metoda vrací DATA_S_SAMEFORMATETC. Člen TYMED není v tomto případě významný a je třeba ho ignorovat. 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` jsou vráceny v parametru `formatOut` .
DV_E_LINDEX	Hodnota pro lindexje neplatná. V současné době se podporuje pouze hodnota -1.
DV_E_FORMATETC	Hodnota parametru `pFormatetc` není platná.
OLE_E_NOTRUNNING	Aplikace není spuštěná.

Implementuje

GetCanonicalFormatEtc(FORMATETC, FORMATETC)

Poznámky

Tento člen je explicitní implementace členu rozhraní. Lze ji použít pouze při DataObject přetypování na IDataObject rozhraní.

Platí pro

Sdílet prostřednictvím