Método ITextRange2::SetText2 (tom.h)

Define o texto desse intervalo.

Sintaxe

HRESULT SetText2(
  [in] long Flags,
  [in] BSTR bstr
);

Parâmetros

[in] Flags

Tipo: long

Sinalizadores que controlam como o texto é inserido no intervalo. O sinalizador pode ser um dos seguintes valores:

tomUnicodeBiDi

tomMathCFCheck

tomUnlink

tomUnhide

tomCheckTextLimit

tomLanguageTag

[in] bstr

Tipo: BSTR

O novo texto.

Retornar valor

Tipo: 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 COM. Para obter mais informações sobre códigos de erro COM, consulte Tratamento de erros em COM.

Código de retorno	Descrição
E_INVALIDARG	Argumento inválido.
E_ACCESSDENIED	O acesso de gravação é negado.
E_OUTOFMEMORY	Memória insuficiente.

Comentários

Se o parâmetro bstr for NULL, o texto no intervalo será excluído.

Esse método é semelhante a ITextRange:: SetText, mas permite que o cliente especifique sinalizadores que controlam várias opções de inserção, incluindo o sinalizador especial tomLanguageTag para obter a marca de idioma BCP-47 para o intervalo. Essa é uma marca de linguagem padrão do setor que pode ser preferível a ITextFont::SetLanguageID, que usa um LCID (identificador de código de linguagem).

Requisitos

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

Confira também

ITextRange2

ITextRange2::GetText2