Partager via


Méthode ITextRange::CanPaste (tom.h)

Détermine si un objet de données peut être collé, à l’aide d’un format spécifié, dans la plage actuelle.

Syntaxe

HRESULT CanPaste(
  VARIANT *pVar,
  long    Format,
  long    *pValue
);

Paramètres

pVar

Type : VARIANT*

IDataObject à coller. Toutefois, le contenu du Presse-papiers est vérifié s’il est collé si l’une des conditions suivantes est vraie :

  • pVar a la valeur Null
  • pVar-punkVal> est null
  • pVar-vt> n’est pas VT_UNKNOWN
  • pVar-punkVal> ne retourne pas d’objet IDataObject lorsqu’il est interrogé pour un objet

Format

Type : long

Format du Presse-papiers utilisé. Zéro représente le meilleur format, qui est généralement RTF, mais CF_UNICODETEXT et d’autres formats sont également possibles. La valeur par défaut est zéro.

pValue

Type : long*

Valeur tomBool qui est tomTrue uniquement si l’objet de données identifié par pVar peut être collé, à l’aide du format spécifié, dans la plage. Ce paramètre peut avoir la valeur Null.

Valeur retournée

Type : HRESULT

La méthode retourne les codes d’erreur COM suivants. Pour plus d’informations sur les codes d’erreur COM, consultez Gestion des erreurs dans COM.

Code de retour Description
S_OK
Le contenu du Presse-papiers ou IDataObject peut être collé.
S_FALSE
Le contenu du Presse-papiers ou IDataObject ne peut pas être collé.

Configuration requise

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête tom.h
DLL Msftedit.dll

Voir aussi

Conceptuel

Copy

ITextRange

Référence

Modèle objet texte