Método ITextSelection::TypeText (tom.h)

Artículo
03/13/2024

Escribe la cadena dada por bstr en esta selección como si alguien lo hubiera escrito. Esto es similar al método SetText subyacente, pero es sensible al estado de clave Insert/Overtype y a la configuración de la interfaz de usuario, como Autocorrección y comillas inteligentes.

Sintaxis

HRESULT TypeText(
  BSTR bstr
);

Parámetros

bstr

Tipo: BSTR

Cadena que se va a escribir en esta selección.

Valor devuelto

Tipo: HRESULT

El método devuelve un valor HRESULT . Si el método se realiza correctamente, devuelve S_OK. Si se produce un error en el método, devuelve uno de los siguientes códigos de error. Para obtener más información sobre los códigos de error COM, vea Control de errores en COM.

Código devuelto	Descripción
E_ACCESSDENIED	El texto está protegido por escritura.
E_INVALIDARG	bstr es null.
E_OUTOFMEMORY	Memoria insuficiente

Comentarios

Este método escribe la cadena dada por bstr en esta selección como si alguien lo hubiera escrito. El uso de TypeText es más rápido que enviar caracteres a través de la función SendMessage , pero es más lento que usar SetText.

TypeText es similar al método SetText subyacente, sin embargo, es sensible al estado de clave Insert/Overtype y a la configuración de la interfaz de usuario, como Autocorrección y comillas inteligentes. Por ejemplo, elimina cualquier selección no degenerada y, a continuación, inserta o sobretipos (según el estado de clave Insert/Overtype), vea el método SetFlags ) la cadena bstr en el punto de inserción, dejando esta selección como punto de inserción después del texto insertado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	tom.h
Archivo DLL	Msftedit.dll