CFontHolder (clase)

Implementa la propiedad Font estándar y encapsula la funcionalidad de un objeto de fuente de Windows y de la interfaz de IFont .

Sintaxis

class CFontHolder

Miembros

Constructores públicos

Nombre	Descripción
CFontHolder::CFontHolder	Construye un objeto CFontHolder.

Métodos públicos

Nombre	Descripción
CFontHolder::GetDisplayString	Recupera la cadena que se muestra en el explorador de propiedades de un contenedor.
CFontHolder::GetFontDispatch	Devuelve la interfaz IDispatch de la fuente.
CFontHolder::GetFontHandle	Devuelve un identificador de una fuente de Windows.
CFontHolder::InitializeFont	Inicializa un objeto CFontHolder.
CFontHolder::QueryTextMetrics	Recupera información de la fuente relacionada.
CFontHolder::ReleaseFont	Desconecta el objeto CFontHolder de las interfaces IFont e IFontNotification.
CFontHolder::Select	Selecciona un recurso de fuente en un contexto de dispositivo.
CFontHolder::SetFont	Conecta el objeto CFontHolder a una interfaz IFont.

Miembros de datos públicos

Nombre	Descripción
CFontHolder::m_pFont	Puntero a la interfaz IFont del objeto CFontHolder.

Comentarios

CFontHolder no tiene una clase base.

Use esta clase para implementar propiedades de fuente personalizadas para el control. Para obtener información sobre cómo crear estas propiedades, vea el artículo Controles ActiveX de MFC: Uso de fuentes.

Jerarquía de herencia

CFontHolder

Requisitos

Encabezado: afxctl.h

CFontHolder::CFontHolder

Construye un objeto CFontHolder.

explicit CFontHolder(LPPROPERTYNOTIFYSINK pNotify);

Parámetros

pNotify
Puntero a la interfaz IPropertyNotifySink de la fuente.

Comentarios

Debe llamar a InitializeFont para inicializar el objeto resultante antes de usarlo.

CFontHolder::GetDisplayString

Recupera una cadena que se puede mostrar en el explorador de propiedades de un contenedor.

BOOL GetDisplayString(CString& strValue);

Parámetros

strValue
Referencia a CString que va a contener la cadena de presentación.

Valor devuelto

Distinto de cero si la cadena se recupera correctamente; de lo contrario, 0.

CFontHolder::GetFontDispatch

Llame a esta función para recuperar un puntero a la interfaz de envío de la fuente.

LPFONTDISP GetFontDispatch();

Valor devuelto

Puntero a la interfaz IFontDisp del objeto CFontHolder. Tenga en cuenta que la función que llama a GetFontDispatch debe llamar a IUnknown::Release en este puntero de interfaz cuando haya terminado.

Comentarios

Llame a InitializeFont antes de llamar a GetFontDispatch.

CFontHolder::GetFontHandle

Llame a esta función para obtener un identificador de una fuente de Windows.

HFONT GetFontHandle();

HFONT GetFontHandle(
    long cyLogical,
    long cyHimetric);

Parámetros

cyLogical
Alto, en unidades lógicas, del rectángulo en el que se dibuja el control.

cyHimetric
Alto, en unidades MM_HIMETRIC, del control.

Valor devuelto

Identificador del objeto Font; en caso contrario, NULL.

Comentarios

La proporción de cyLogical y cyHimetric se usa para calcular el tamaño de presentación adecuado, en unidades lógicas, del tamaño de punto de la fuente expresado en unidades MM_HIMETRIC:

Tamaño de presentación = (cyLogical / cyHimetric) X tamaño de fuente

La versión sin parámetros devuelve un identificador de una fuente con el tamaño correcto para la pantalla.

CFontHolder::InitializeFont

Inicializa un objeto CFontHolder.

void InitializeFont(
    const FONTDESC* pFontDesc = NULL,
    LPDISPATCH pFontDispAmbient = NULL);

Parámetros

pFontDesc
Puntero a una estructura de descripción de fuente (FONTDESC) que especifica las características de la fuente.

pFontDispAmbient
Puntero a la propiedad Font de ambiente del contenedor.

Comentarios

Si pFontDispAmbient no es NULL, el objeto CFontHolder se conecta a un clon de la interfaz IFont usada por la propiedad Font de ambiente del contenedor.

Si pFontDispAmbient es NULL, se crea un nuevo objeto Font a partir de la descripción de fuente a la que apunta pFontDesc o, si pFontDesc es NULL, a partir de una descripción predeterminada.

Llame a esta función después de construir un objeto CFontHolder.

CFontHolder::m_pFont

Puntero a la interfaz IFont del objeto CFontHolder.

LPFONT m_pFont;

CFontHolder::QueryTextMetrics

Recupera información sobre la fuente física representada por el objeto CFontHolder.

void QueryTextMetrics(LPTEXTMETRIC lptm);

Parámetros

lptm
Puntero a una estructura TEXTMETRICque va a recibir la información.

CFontHolder::ReleaseFont

Esta función desconecta el objeto CFontHolder de su interfaz IFont.

void ReleaseFont();

CFontHolder::Select

Llame a esta función para seleccionar la fuente del control en el contexto de dispositivo especificado.

CFont* Select(
    CDC* pDC,
    long cyLogical,
    long cyHimetric);

Parámetros

pDC
Contexto de dispositivo en el que se selecciona la fuente.

cyLogical
Alto, en unidades lógicas, del rectángulo en el que se dibuja el control.

cyHimetric
Alto, en unidades MM_HIMETRIC, del control.

Valor devuelto

Puntero a la fuente que se va a reemplazar.

Comentarios

Vea GetFontHandle para obtener una explicación de los parámetros cyLogical y cyHimetric.

CFontHolder::SetFont

Libera cualquier fuente existente y conecta el objeto CFontHolder a una interfaz IFont.

void SetFont(LPFONT pNewFont);

Parámetros

pNewFont
Puntero a la nueva interfaz IFont.

Consulte también

Gráfico de jerarquías
CPropExchange (clase)