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

  • Artigo

Obtém um objeto ITextRange com o texto formatado do intervalo especificado.

Sintaxe

HRESULT GetFormattedText(
  ITextRange **ppRange
);

Parâmetros

ppRange

Tipo: ITextRange**

O objeto ITextRange com o texto formatado.

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_INVALIDARG
 ppRange é nulo.
E_OUTOFMEMORY
 Sem memória.

Comentários

Esse método, que equivale a um alias para o método ITextRange::GetDuplicate, está incluído para ser amigável ao Microsoft Visual Basic for Applications (VBA). O método retorna o texto formatado em um intervalo. 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 compatíveis com 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 do Microsoft Visual Basic a seguir usa a propriedade FormattedText para substituir o texto em um 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

ITextRange

Referência

SetFormattedText

Modelo de objeto de texto