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 |
|---|---|
|
O texto é protegido por gravação. |
|
bstr é nulo. |
|
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
Referência