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

Artigo
08/26/2023

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