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

  • Artículo

Establece los atributos de carácter de este intervalo en los del objeto ITextFont especificado.

Sintaxis

HRESULT SetFont(
  [in] ITextFont *pFont
);

Parámetros

[in] pFont

Tipo: ITextFont*

Objeto de fuente con el formato de caracteres deseado.

Valor devuelto

Tipo: HRESULT

El método devuelve un valor HRESULT . Si el método se realiza correctamente, devuelve S_OK. Si se produce un error en el método, devuelve uno de los siguientes códigos de error. Para obtener más información sobre los códigos de error COM, vea Control de errores en COM.

Código devuelto Descripción
Valor
 Significado
E_ACCESSDENIED
 El texto está protegido.
E_INVALIDARG
 pFont es null.
E_OUTOFMEMORY
 Memoria insuficiente

Comentarios

Para los cambios de formato ocasionales, use el método ITextRange::SetFont . Sin embargo, para realizar varios cambios de formato de caracteres, es más eficaz usar un duplicado de fuente. Esto se debe a que cada vez que se ejecuta una instrucción como range.font.bold = tomTrue, se asigna y libera un objeto de fuente. Sin embargo, se puede asignar una fuente duplicada una vez y usarse muchas veces. Además, puede guardar la fuente duplicada, restablecerla a los estados predeterminados o no definidos con el método Reset y asignarle valores según sea necesario para el procesamiento de texto enriquecido. Para obtener código de ejemplo que muestra cómo usar duplicados de fuente, consulte Uso de un duplicado de fuente.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado tom.h
Archivo DLL Msftedit.dll

Consulte también

Conceptual

ITextRange

Referencia

Reset

Modelo de objetos de texto