ITextSelection ::TypeText, méthode (tom.h)

Article
08/26/2023

Tapez la chaîne donnée par bstr à cette sélection comme si quelqu’un l’avait tapée. Cela est similaire à la méthode SetText sous-jacente, mais est sensible à l’état de la clé Insert/Overtype et aux paramètres d’interface utilisateur tels que la correction automatique et les guillemets intelligents.

Syntaxe

HRESULT TypeText(
  BSTR bstr
);

Paramètres

bstr

Type : BSTR

Chaîne à taper dans cette sélection.

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

Cette méthode tape la chaîne donnée par bstr à cette sélection comme si quelqu’un l’avait tapée. L’utilisation de TypeText est plus rapide que l’envoi de caractères via la fonction SendMessage , mais elle est plus lente que l’utilisation de SetText.

TypeText est similaire à la méthode SetText sous-jacente, mais elle est sensible à l’état de la clé Insert/Overtype et aux paramètres d’interface utilisateur tels que la correction automatique et les guillemets intelligents. Par exemple, il supprime toute sélection non générée, puis insère ou surtype (en fonction de l’état de clé Insert/Overtype ( voir la méthode SetFlags ) la chaîne bstr au point d’insertion, en laissant cette sélection comme point d’insertion après le texte inséré.

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