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

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

Confira também

Conceitual

ITextSelection

Outros recursos

Referência

SendMessage

SetFlags

SetText

Modelo de objeto de texto