Classe CFontHolder

Implementa a propriedade fonte de estoque e encapsula a funcionalidade de um objeto de fonte do Windows e da interface IFont.

Sintaxe

class CFontHolder

Membros

Construtores públicos

Nome	Descrição
CFontHolder::CFontHolder	Constrói um objeto CFontHolder.

Métodos públicos

Nome	Descrição
CFontHolder::GetDisplayString	Recupera a cadeia de caracteres exibida no navegador de propriedades de um contêiner.
CFontHolder::GetFontDispatch	Retorna a interface da fonte IDispatch.
CFontHolder::GetFontHandle	Retorna um identificador para uma fonte do Windows.
CFontHolder::InitializeFont	Inicializa um objeto CFontHolder.
CFontHolder::QueryTextMetrics	Recupera informações para a fonte relacionada.
CFontHolder::ReleaseFont	Desconecta o objeto CFontHolder das interfaces IFont e IFontNotification.
CFontHolder::Select	Seleciona um recurso de fonte em um contexto de dispositivo.
CFontHolder::SetFont	Conecta o objeto CFontHolder a uma interface IFont.

Membros de Dados Públicos

Nome	Descrição
CFontHolder::m_pFont	Um ponteiro para a interface IFont do objeto CFontHolder.

Comentários

CFontHolder não tem uma classe base.

Use essa classe para implementar propriedades de fonte personalizadas no seu controle. Para obter informações sobre como criar essas propriedades, consulte o artigo Controles ActiveX: usar fontes.

Hierarquia de herança

CFontHolder

Requisitos

Cabeçalho: afxctl.h

CFontHolder::CFontHolder

Constrói um objeto CFontHolder.

explicit CFontHolder(LPPROPERTYNOTIFYSINK pNotify);

Parâmetros

pNotify
Ponteiro para a interface IPropertyNotifySink da fonte.

Comentários

Você deve chamar InitializeFont para inicializar o objeto resultante antes de usá-lo.

CFontHolder::GetDisplayString

Recupera a cadeia de caracteres que pode ser exibida no navegador de propriedades de um contêiner.

BOOL GetDisplayString(CString& strValue);

Parâmetros

strValue
Referência ao CString destinado a manter a cadeia de caracteres de exibição.

Valor de Devolução

Não zero se a cadeia de caracteres for recuperada com êxito; caso contrário, 0.

CFontHolder::GetFontDispatch

Chame essa função para recuperar um ponteiro para a interface de expedição da fonte.

LPFONTDISP GetFontDispatch();

Valor de Devolução

Um ponteiro para a interface IFontDisp do objeto CFontHolder. Observe que a função que chama GetFontDispatch deve chamar IUnknown::Release nesse ponteiro de interface quando terminar com ela.

Comentários

Chame InitializeFont antes de chamar GetFontDispatch.

CFontHolder::GetFontHandle

Chame essa função para obter um identificador para uma fonte do Windows.

HFONT GetFontHandle();

HFONT GetFontHandle(
    long cyLogical,
    long cyHimetric);

Parâmetros

cyLogical
Altura, em unidades lógicas, do retângulo no qual o controle é desenhado.

cyHimetric
Altura, em unidades MM_HIMETRIC, do controle.

Valor de Devolução

Um identificador para o objeto Fonte; caso contrário, NULL.

Comentários

A taxa de cyLogical e cyHimetric é usada para calcular o tamanho de exibição adequado, em unidades lógicas, para o tamanho do ponto da fonte expresso em unidades de MM_HIMETRIC:

Tamanho da exibição = tamanho da fonte X ( cyLogical / cyHimetric)

A versão sem parâmetros retorna um identificador para uma fonte dimensionada corretamente para a tela.

CFontHolder::InitializeFont

Inicializa um objeto CFontHolder.

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

Parâmetros

pFontDesc
Ponteiro para uma estrutura de descrição de fonte ( FONTDESC) que especifica as características da fonte.

pFontDispAmbient
Ponteiro para a propriedade Fonte ambiente do contêiner.

Comentários

Se pFontDispAmbient não for NULL, o objeto CFontHolder será conectado a um clone da interface IFont usada pela propriedade Fonte ambiente do contêiner.

Se pFontDispAmbient for NULL, um novo objeto Font será criado a partir da descrição da fonte apontada por pFontDesc ou, se pFontDesc for NULL, a partir de uma descrição padrão.

Chame essa função depois de construir um objeto CFontHolder.

CFontHolder::m_pFont

Um ponteiro para a interface IFont do objeto CFontHolder.

LPFONT m_pFont;

CFontHolder::QueryTextMetrics

Recupera informações sobre a fonte física representada pelo objeto CFontHolder.

void QueryTextMetrics(LPTEXTMETRIC lptm);

Parâmetros

lptm
Um ponteiro para uma estrutura TEXTMETRICque receberá as informações.

CFontHolder::ReleaseFont

Essa função desconecta o objeto CFontHolder de sua interface IFont.

void ReleaseFont();

CFontHolder::Select

Chame essa função para selecionar a fonte do controle no contexto do dispositivo especificado.

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

Parâmetros

pDC
Contexto do dispositivo para o qual a fonte está selecionada.

cyLogical
Altura, em unidades lógicas, do retângulo no qual o controle é desenhado.

cyHimetric
Altura, em unidades MM_HIMETRIC, do controle.

Valor de Devolução

Um ponteiro para a fonte que está sendo substituída.

Comentários

Consulte GetFontHandle para obter uma discussão sobre os parâmetros cyLogical e cyHimetric.

CFontHolder::SetFont

Libera qualquer fonte existente e conecta o objeto CFontHolder a uma interface IFont.

void SetFont(LPFONT pNewFont);

Parâmetros

pNewFont
Ponteiro para a nova interface IFont.

Confira também

Gráfico da hierarquia
Classe CPropExchange