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.