Método ITextRange::SetFont (tom.h)
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 |
|---|---|
|
Significado |
|
O texto está protegido. |
|
pFont é nulo. |
|
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
Referência