DataObject.IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Windows

Assembly:: PresentationCore.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Fornisce una struttura FORMATETC standard logicamente equivalente a una struttura più complessa. Utilizzare questo metodo per determinare se due strutture FORMATETC diverse restituiscono gli stessi dati, eliminando la necessità di rendering duplicati.

 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;

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

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

[<System.Security.SecurityCritical>]
abstract member System.Runtime.InteropServices.ComTypes.IDataObject.GetCanonicalFormatEtc : FORMATETC * FORMATETC -> int
override this.System.Runtime.InteropServices.ComTypes.IDataObject.GetCanonicalFormatEtc : FORMATETC * FORMATETC -> int

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

Parametri

pformatetcIn: FORMATETC

Un puntatore a una struttura FORMATETC, passato per riferimento, che definisce formato, supporto e periferica di destinazione che il chiamante desidera utilizzare per recuperare dati in una chiamata successiva quale GetData(FORMATETC, STGMEDIUM). Il membro TYMED non è significativo in questo caso e deve essere ignorato.

pformatetcOut: FORMATETC

Quando termina, questo metodo contiene un puntatore a una struttura FORMATETC che contiene le informazioni più generali possibili per un rendering specifico, che lo rendono equivalente in modo canonico a formatetcIn. Il chiamante deve allocare questa struttura e il metodo GetCanonicalFormatEtc(FORMATETC, FORMATETC) deve inserire i dati. Per recuperare dati in una chiamata successiva quale GetData(FORMATETC, STGMEDIUM), il chiamante utilizza il valore fornito di formatOut, a meno che il valore fornito non sia null. Questo valore è null se il metodo restituisce DATA_S_SAMEFORMATETC. Il membro TYMED non è significativo in questo caso e deve essere ignorato. Questo parametro viene passato non inizializzato.

Restituisce

Int32

Questo metodo supporta i valori restituiti standard E_INVALIDARG, E_UNEXPECTED e E_OUTOFMEMORY, nonché quanto segue:

Valore	Descrizione
S_OK	La struttura FORMATETC restituita è diversa da quella passata.
DATA_S_SAMEFORMATETC	Le strutture FORMATETC sono uguali e nel parametro `formatOut` viene restituito `null`.
DV_E_LINDEX	È presente un valore non valido per lindex; attualmente, è supportato solo il valore -1.
DV_E_FORMATETC	È presente un valore non valido per il parametro `pFormatetc`.
OLE_E_NOTRUNNING	L'applicazione non è in esecuzione.

Implementazioni

GetCanonicalFormatEtc(FORMATETC, FORMATETC)

Attributi: SecurityCriticalAttribute

Commenti

Questo membro è un’implementazione esplicita di un membro di interfaccia. Può essere utilizzato solo quando si esegue il cast dell'istanza DataObject a un'interfaccia IDataObject.

Si applica a