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

Article
03/03/2024

Obtient un objet ITextRange avec le texte mis en forme de la plage spécifiée.

Syntaxe

HRESULT GetFormattedText(
  ITextRange **ppRange
);

Paramètres

ppRange

Type : ITextRange**

Objet ITextRange avec le texte mis en forme.

Valeur retournée

Type : HRESULT

Si la méthode réussit, elle retourne S_OK. Si la méthode échoue, elle retourne l’un des codes d’erreur suivants. Pour plus d’informations sur les codes d’erreur COM, consultez Gestion des erreurs dans COM.

Code de retour	Description
E_INVALIDARG	ppRange a la valeur null.
E_OUTOFMEMORY	Mémoire insuffisante.

Remarques

Cette méthode, qui équivaut à un alias pour la méthode ITextRange ::GetDuplicate , est incluse pour être compatible avec Microsoft Visual Basic pour Applications (VBA). La méthode retourne le texte mis en forme dans une plage. Si ITextRange n’appartient pas au même moteur TOM (Text Object Model), appelez IUnknown ::QueryInterface pour une interface IDataObject .

Parmi les formats généralement pris en charge par IDataObject figurent CF_TEXT et CF_RTF. En outre, les formats privés peuvent être utilisés pour référencer les propres formats de texte enrichi internes d’une solution de texte. L’exemple Microsoft Visual Basic suivant utilise la propriété FormattedText pour remplacer le texte d’une plage2 par le texte mis en forme dans range1.

range2.FormattedText = range1.FormattedText

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