ITextRange ::Copy, méthode (tom.h)

Article
03/03/2024

Copie le texte dans un objet de données.

Syntaxe

HRESULT Copy(
  VARIANT *pVar
);

Paramètres

pVar

Type : VARIANT*

Texte copié. pVar-ppunkVal> est le paramètre out pour un objet IDataObject à condition que les conditions suivantes existent :

pVar-vt> = (VT_UNKNOWN | VT_BYREF)
pVar n’est pas null
pVar-ppunkVal> n’est pas null

Sinon, le Presse-papiers est utilisé.

Valeur retournée

Type : HRESULT

Cette méthode retourne une valeur HRESULT . Si elle réussit, elle retourne S_OK. Sinon, il retourne E_OUTOFMEMORY.

Remarques

Les méthodes ITextRange ::Cut, ITextRange ::Copy et ITextRange ::P aste vous permettent d’effectuer les opérations Cut, Copier et Coller habituelles sur un objet de plage à l’aide d’un IDataObject, ce qui ne modifie pas le contenu du Presse-papiers. Parmi les formats de Presse-papiers généralement pris en charge figurent CF_TEXT et CF_RTF. En outre, les formats de Presse-papiers privés peuvent être utilisés pour référencer les propres formats de texte enrichi internes d’une solution de texte.

Pour copier et remplacer du texte brut, vous pouvez utiliser les méthodes ITextRange ::GetText et ITextRange ::SetText . Pour copier du texte mis en forme de la plage r1 vers la plage r2 sans utiliser le Presse-papiers, vous pouvez utiliser les méthodes Copier-Coller, ainsi que les méthodes ITextRange ::GetFormattedText et ITextRange ::SetFormattedText, comme illustré dans l’exemple Microsoft Visual Basic suivant :

r2.GetFormattedText = r1.GetFormattedText

Configuration requise

Condition requise	Valeur
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