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

Artigo
03/03/2024

Digita a cadeia de caracteres fornecida por bstr nesta seleção como se alguém a digitasse. Isso é semelhante ao método SetText subjacente, mas é sensível ao estado da chave Insert/Overtype e às configurações da interface do usuário, como AutoCorreção e aspas inteligentes.

Sintaxe

HRESULT TypeText(
  BSTR bstr
);

Parâmetros

bstr

Tipo: BSTR

Cadeia de caracteres para digitar nessa seleção.

Retornar valor

Tipo: HRESULT

O método retorna um valor HRESULT . Se o método for bem-sucedido, ele retornará S_OK. Se o método falhar, ele retornará um dos seguintes códigos de erro. Para obter mais informações sobre códigos de erro COM, consulte Tratamento de erros em COM.

Código de retorno	Descrição
E_ACCESSDENIED	O texto é protegido por gravação.
E_INVALIDARG	bstr é nulo.
E_OUTOFMEMORY	Sem memória.

Comentários

Esse método digita a cadeia de caracteres fornecida por bstr nesta seleção como se alguém a digitasse. Usar TypeText é mais rápido do que enviar caracteres por meio da função SendMessage , mas é mais lento do que usar SetText.

TypeText é semelhante ao método SetText subjacente, no entanto, ele é sensível ao estado da chave Insert/Overtype e às configurações da interface do usuário, como AutoCorreção e aspas inteligentes. Por exemplo, ele exclui qualquer seleção não genérica e insere ou sobretipos (dependendo do estado da chave Insert/Overtype — consulte o método SetFlags ) a cadeia de caracteres bstr no ponto de inserção, deixando essa seleção como um ponto de inserção após o texto inserido.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	tom.h
DLL	Msftedit.dll