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

Article
08/26/2023

Définit le texte de cette plage.

Syntaxe

HRESULT SetText(
  [in] BSTR bstr
);

Paramètres

[in] bstr

Type : BSTR

Texte qui remplace le texte actuel dans cette plage. Si la valeur est null, le texte actuel est supprimé.

Valeur retournée

Type : HRESULT

La méthode retourne une valeur 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_ACCESSDENIED	Le texte est protégé en écriture.
E_INVALIDARG	bstr a la valeur Null.
E_OUTOFMEMORY	Mémoire insuffisante.

Remarques

ITextRange::SetText remplace le texte de la plage par le nouveau texte. En revanche, TypeText remplace la sélection par le texte bstr et laisse la sélection comme point d’insertion juste après le texte inséré, comme si vous aviez tapé le texte dans. Pour le comportement de sélection de l’interface utilisateur, consultez TypeText.

Si, après avoir appelé ITextRange::SetText, vous appelez ITextRange::GetText, vous récupérez le même texte que celui que vous avez défini avec la méthode ITextRange::SetText (sauf si une autre plage a modifié ce texte entre les appels).

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