ITextRange ::Copy, méthode (tom.h)
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
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 |
Voir aussi
Conceptuel
Référence