Méthode ITextServices::TxGetText (textserv.h)

Article
08/26/2023

Retourne tout le texte brut Unicode dans le contrôle sous la forme d’un BSTR.

Syntaxe

HRESULT TxGetText(
  BSTR *pbstrText
);

Paramètres

pbstrText

Type : BSTR *

Texte brut Unicode.

Valeur retournée

Type : HRESULT

Si le texte est correctement retourné dans l’argument de sortie, la valeur de retour est S_OK.

Si la méthode échoue, la valeur de retour est l’un des codes HRESULT suivants. Pour plus d’informations sur les codes d’erreur COM, consultez Gestion des erreurs dans COM.

Code de retour	Description
E_INVALIDARG	Pointeur BSTR non valide passé.
E_OUTOFMEMORY	Impossible d’allouer de la mémoire pour la copie du texte.

Remarques

L’hôte (appelant) prend la propriété du BSTR retourné.

D’autres façons de récupérer des données de texte brut sont d’utiliser WM_GETTEXT ou la méthode GetText du modèle objet texte (TOM).

S’il n’y a pas de texte dans le contrôle, le BSTR est alloué et 0x000D est retourné dans celui-ci.

Le texte retourné ne sera pas nécessairement terminé par une valeur Null.

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	textserv.h
DLL	Msftedit.dll