Metodo ITextSelection::TypeText (tom.h)

Articolo
03/03/2024

Digita la stringa specificata da bstr in questa selezione come se qualcuno lo digitasse. È simile al metodo SetText sottostante, ma è sensibile allo stato della chiave Insert/Overtype e alle impostazioni dell'interfaccia utente, ad esempio Correzione automatica e virgolette intelligenti.

Sintassi

HRESULT TypeText(
  BSTR bstr
);

Parametri

bstr

Tipo: BSTR

Stringa da digitare in questa selezione.

Valore restituito

Tipo: HRESULT

Il metodo restituisce un valore HRESULT . Se il metodo ha esito positivo, restituisce S_OK. Se il metodo ha esito negativo, restituisce uno dei codici di errore seguenti. Per altre informazioni sui codici di errore COM, vedere Gestione degli errori in COM.

Codice restituito	Descrizione
E_ACCESSDENIED	Il testo è protetto da scrittura.
E_INVALIDARG	bstr è Null.
E_OUTOFMEMORY	Memoria insufficiente.

Commenti

Questo metodo digita la stringa specificata da bstr in questa selezione come se qualcuno lo digitasse. L'uso di TypeText è più veloce rispetto all'invio di caratteri tramite la funzione SendMessage , ma è più lento rispetto all'uso di SetText.

TypeText è simile al metodo SetText sottostante, ma è sensibile allo stato della chiave Insert/Overtype e alle impostazioni dell'interfaccia utente, ad esempio Correzione automatica e virgolette intelligenti. Ad esempio, elimina qualsiasi selezione non generata e quindi inserisce o sovratipi (a seconda dello stato della chiave Insert/Overtype, vedere il metodo SetFlags ) la stringa bstr nel punto di inserimento, lasciando questa selezione come punto di inserimento seguendo il testo inserito.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	tom.h
DLL	Msftedit.dll