ClipboardObject.IDataObject.GetCanonicalFormatEtc – metoda

Článek
10/27/2012

Poskytuje standardní FORMATETC struktury, která je logicky ekvivalentní složitější strukturu.Tuto metodu lze použít k určení, zda jsou dva různé FORMATETC struktury vrátit stejná data, muset duplicitní vykreslování.

Obor názvů: Microsoft.VisualStudio.Data.Framework
Sestavení: Microsoft.VisualStudio.Data.Framework (v Microsoft.VisualStudio.Data.Framework.dll)

Syntaxe

'Deklarace
Private Function GetCanonicalFormatEtc ( _
    pformatectIn As FORMATETC(), _
    pformatetcOut As FORMATETC() _
) As Integer Implements IDataObject.GetCanonicalFormatEtc

int IDataObject.GetCanonicalFormatEtc(
    FORMATETC[] pformatectIn,
    FORMATETC[] pformatetcOut
)

private:
virtual int GetCanonicalFormatEtc(
    array<FORMATETC>^ pformatectIn, 
    array<FORMATETC>^ pformatetcOut
) sealed = IDataObject::GetCanonicalFormatEtc

private abstract GetCanonicalFormatEtc : 
        pformatectIn:FORMATETC[] * 
        pformatetcOut:FORMATETC[] -> int 
private override GetCanonicalFormatEtc : 
        pformatectIn:FORMATETC[] * 
        pformatetcOut:FORMATETC[] -> int

Jazyk JScript nepodporuje explicitní implementace rozhraní.

Parametry

pformatectIn
Typ: array<Microsoft.VisualStudio.OLE.Interop.FORMATETC[]
Odkaz na FORMATETC struktury předání odkazem, který definuje formát, střední a cílové zařízení, který chcete použít k načtení dat v následné volání jako volající IDataObject.GetData.tymed v tomto případě není důležité a budou ignorovány.

pformatetcOut
Typ: array<Microsoft.VisualStudio.OLE.Interop.FORMATETC[]
Při vrácení metody obsahuje ukazatel FORMATETC strukturu, která obsahuje většinu obecné informace pro specifické vykreslení, takže canonically rovnocenné pformatectIn .Volající musí přidělit tuto strukturu a GetCanonicalFormatEtc metoda musí vyplnit údaje.Načtení dat v následné volání jako IDataObject.GetData, volající používá zadané hodnoty pformatetcOut , pokud je předaná hodnota je null .Tato hodnota je null, vrátí metoda DATA_S_SAMEFORMATETC .tymed v tomto případě není důležité a budou ignorovány.Tento parametr je předán inicializována.

Vrácená hodnota

Typ: System.Int32
Tato metoda podporuje standardní vrácené hodnoty E_INVALIDARG , E_FAIL , E_UNEXPECTED , a E_OUTOFMEMORY , a také následující:

Value	Description
S_OK	Vrácené struktura FORMATETC se liší od toho, který byl předán.
DATA_S_SAMEFORMATETC	FORMATETC struktury jsou stejné a odkaz s hodnotou null je vrácen jako pformatetcOut parametr.
DV_E_LINDEX	Je neplatná hodnota pro lindex; v současné době je podporován pouze -1.
DV_E_FORMATETC	Neplatná hodnota je pformatectIn parametr.
OLE_E_NOTRUNNING	Aplikace není spuštěna.

Implementuje

IDataObject.GetCanonicalFormatEtc(array<FORMATETC[], array<FORMATETC[])

Poznámky

Pokud objekt schránky obtéká existující IDataObject (z Microsoft.VisualStudio.OLE.Interop oboru názvů), tato metoda deleguje volání odpovídajících GetCanonicalFormatEtc z daného oboru názvů.V opačném případě se pokusí přeložit volání GetCanonicalFormatEtc z System.Runtime.InteropServices.ComTypes oboru názvů, v případě objektu schránky může být obtékání existující IDataObject.

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

ClipboardObject Třída

Microsoft.VisualStudio.Data.Framework – obor názvů

Sdílet prostřednictvím