Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais
Nous recommandons d’utiliser Visual Studio 2017

ClipboardObject.IDataObject.GetCanonicalFormatEtc, méthode

Fournit une structure FORMATETC standard qui équivaut logiquement à une structure plus complexe. Utilisez cette méthode pour déterminer si deux structures différentes d'FORMATETC retournent les mêmes données, en supprimant le besoin de rendu en double.

Espace de noms :  Microsoft.VisualStudio.Data.Framework
Assembly :  Microsoft.VisualStudio.Data.Framework (dans Microsoft.VisualStudio.Data.Framework.dll)

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

Paramètres

formatIn
Type : FORMATETC

Une référence à une structure d'FORMATETC, passée par référence, qui définit le format, le média, et le périphérique cible que l'appelant souhaite utiliser pour récupérer les données dans un appel suivant, tel que l'IDataObject.GetData. Le membre tymed n'est pas significatif dans ce cas et doit être ignoré.

formatOut
Type : FORMATETC

Lorsque cette méthode est retournée, ce paramètre contient un pointeur vers une structure d'un FORMATETC qui contient des informations générales possibles pour un rendu spécifique, ce qui canoniquement l'équivalent à pformatectIn. L'appelant doit allouer cette structure, et la méthode GetCanonicalFormatEtc doit remplir les données. Pour récupérer des données dans un appel suivant, tel que l'IDataObject.GetData, les utilisations de l'appelant la valeur fournie d'pformatetcOut, sauf que la valeur fournie est null. Cette valeur est null si la méthode retourne DATA_S_SAMEFORMATETC. Le membre tymed n'est pas significatif dans ce cas et doit être ignoré. Ce paramètre est passé sans être initialisé.

Valeur de retour

Type : Int32
Cette méthode prend en charge les valeurs de retour standard, E_INVALIDARG, E_UNEXPECTEDet E_OUTOFMEMORY, ainsi que les éléments suivants :

Valeur

Description

S_OK

La structure retournée par FORMATETC est différente de celle qui a été passée.

DATA_S_SAMEFORMATETC

Les structures de FORMATETC sont identiques et une référence null est retournée dans le paramètre formatOut.

DV_E_LINDEX

Il existe une valeur non valide pour lindex ; actuellement, seule la valeur -1 est prise en charge.

DV_E_FORMATETC

Il existe une valeur non valide pour le paramètre formatIn.

OLE_E_NOTRUNNING

L'application n'est pas en cours d'exécution.

Implémentations

IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC)

Cette méthode délègue l'appel à l'GetCanonicalFormatEtc correspondant de l'espace de noms System.Runtime.InteropServices.ComTypes, en supposant que l'objet de Presse-papiers encapsule IDataObjectexistant.

Afficher: