Compartilhar via


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

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

Confira também

Conceitual

GetDuplicate

GetFormattedText

ITextRange

Referência

Modelo de objeto de texto