Método ITextRange::SetText (tom.h)

Define o texto nesse intervalo.

Sintaxe

HRESULT SetText(
  [in] BSTR bstr
);

Parâmetros

[in] bstr

Tipo: BSTR

Texto que substitui o texto atual nesse intervalo. Se for nulo, o texto atual será excluído.

Valor retornado

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

ITextRange::SetText substitui o texto no intervalo pelo novo texto. Por outro lado, TypeText substitui a seleção pelo texto bstr e deixa a seleção como um ponto de inserção logo após o texto inserido, assim como se você tivesse digitado o texto. Para comportamento de seleção da interface do usuário, consulte TypeText.

Se, depois de chamar ITextRange::SetText, você chamar ITextRange::GetText, receberá de volta o mesmo texto definido com o método ITextRange::SetText (a menos que algum outro intervalo tenha alterado esse texto entre as chamadas).

Requisitos

   
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

Gettext

ITextRange

Referência

Modelo de objeto de texto

Typetext