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 ( _
    ByRef formatIn As FORMATETC, _
    <OutAttribute> ByRef formatOut As FORMATETC _
) As Integer Implements IDataObject.GetCanonicalFormatEtc

int IDataObject.GetCanonicalFormatEtc(
    ref FORMATETC formatIn,
    out FORMATETC formatOut
)

private:
virtual int GetCanonicalFormatEtc(
    FORMATETC% formatIn, 
    [OutAttribute] FORMATETC% formatOut
) sealed = IDataObject::GetCanonicalFormatEtc

private abstract GetCanonicalFormatEtc : 
        formatIn:FORMATETC byref * 
        formatOut:FORMATETC byref -> int 
private override GetCanonicalFormatEtc : 
        formatIn:FORMATETC byref * 
        formatOut:FORMATETC byref -> int

Jazyk JScript nepodporuje explicitní implementace rozhraní.

Parametry

formatIn
Typ: System.Runtime.InteropServices.ComTypes.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.

formatOut
Typ: System.Runtime.InteropServices.ComTypes.FORMATETC%
Tato metoda vrátí, tento parametr obsahuje ukazatel FORMATETC struktura, která obsahuje většinu obecných informací 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_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 formatOut parametr.
DV_E_LINDEX	Je neplatná hodnota pro lindex; v současné době je podporován pouze -1.
DV_E_FORMATETC	Neplatná hodnota je formatIn parametr.
OLE_E_NOTRUNNING	Aplikace není spuštěna.

Implementuje

IDataObject.GetCanonicalFormatEtc(FORMATETC%, FORMATETC%)

Poznámky

Tato metoda deleguje volání odpovídajících GetCanonicalFormatEtc z System.Runtime.InteropServices.ComTypes oboru názvů, za předpokladu, že je obtékání objektu schránky 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