ITextRange::SetText, méthode (tom.h)
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 |
|---|---|
|
Le texte est protégé en écriture. |
|
bstr a la valeur Null. |
|
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 |
Voir aussi
Conceptuel
Référence