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

Artigo
03/13/2024

Define o texto formatado desse texto de intervalo para o texto formatado do intervalo especificado.

Sintaxe

HRESULT SetFormattedText(
  [in] ITextRange *pRange
);

Parâmetros

[in] pRange

Tipo: ITextRange*

O texto formatado para substituir o texto desse intervalo.

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. 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 está protegido.
E_INVALIDARG	pRange é nulo.
E_OUTOFMEMORY	Sem memória.

Comentários

Se o ITextRange não pertencer ao mesmo mecanismo TOM (Modelo de Objeto de Texto), chame IUnknown::QueryInterface para uma interface IDataObject .

Entre os formatos normalmente suportados pelo IDataObject estão CF_TEXT e CF_RTF. Além disso, os formatos privados podem ser usados para referenciar os próprios formatos de rich text internos de uma solução de texto. O exemplo a seguir do Microsoft Visual Basic usa a propriedade FormattedText para substituir o texto no intervalo2 pelo texto formatado no intervalo1.

range2.FormattedText = range1.FormattedText

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