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

  • Artigo

Define os atributos de caractere desse intervalo como os do objeto ITextFont especificado.

Sintaxe

HRESULT SetFont(
  [in] ITextFont *pFont
);

Parâmetros

[in] pFont

Tipo: ITextFont*

Um objeto de fonte com o formato de caractere desejado.

Retornar valor

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
Valor
 Significado
E_ACCESSDENIED
 O texto está protegido.
E_INVALIDARG
 pFont é nulo.
E_OUTOFMEMORY
 Sem memória.

Comentários

Para alterações de formato ocasionais, use o método ITextRange::SetFont . No entanto, para fazer várias alterações de formatação de caracteres, é mais eficiente usar uma duplicata de fonte. Isso ocorre porque toda vez que você executa uma instrução como range.font.bold = tomTrue, um objeto de fonte é alocado e liberado. No entanto, uma duplicata de fonte pode ser alocada uma vez e usada muitas vezes. Além disso, você pode salvar a fonte duplicada, redefini-la para os estados padrão ou indefinidos com o método Reset e dar-lhe valores conforme necessário para o processamento de rich text. Para obter um código de exemplo que mostra como usar duplicatas de fonte, consulte Usando uma duplicata de fonte.

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

Redefinir

Modelo de objeto de texto