Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
GetCanonicalFormatEtc, méthode
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

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 FORMATETC différentes retourneraient les mêmes données, rendant ainsi superflu le rendu en double.

Espace de noms :  System.Runtime.InteropServices.ComTypes
Assembly :  System (dans System.dll)

int GetCanonicalFormatEtc(
	ref FORMATETC formatIn,
	out FORMATETC formatOut
)

Paramètres

formatIn
Type : System.Runtime.InteropServices.ComTypes.FORMATETC
Pointeur vers une structure FORMATETC, passée par référence, qui définit le format, le support et le périphérique cible que l'appelant souhaite utiliser pour récupérer des données dans un appel suivant, tel que GetData. Le membre TYMED n'est pas significatif dans ce cas et doit être ignoré.
formatOut
Type : System.Runtime.InteropServices.ComTypes.FORMATETC
Cette méthode retourne un pointeur vers une structure FORMATETC qui contient les informations les plus générales possibles pour un rendu spécifique, en le rendant canoniquement équivalent à formatetIn. 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 GetData, l'appelant utilise la valeur fournie de formatOut, à moins que la valeur fournie ne soit 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 : System.Int32
Cette méthode prend en charge les valeurs de retour E_INVALIDARG, E_UNEXPECTED et E_OUTOFMEMORY standard, ainsi que les suivantes :

Valeur

Description

S_OK

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

DATA_S_SAMEFORMATETC

Les structures FORMATETC sont identiques et la valeur 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 pFormatetc.

OLE_E_NOTRUNNING

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

Pour plus d'informations sur IDataObject::GetCanonicalFormatEtc, consultez MSDN Library.

.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2015 Microsoft