Partilhar via

Classe CFontHolder

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Implementa a propriedade padrão Font e encapsula a funcionalidade de um objeto de fonte do Windows e da IFont interface.

Sintaxe

class CFontHolder

Membros

Construtores Públicos

Nome Description
CFontHolder::CFontHolder Constrói um CFontHolder objeto.

Métodos Públicos

Nome Description
CFontHolder::GetDisplayString Recupera a cadeia apresentada no navegador de propriedades de um contentor.
CFontHolder::GetFontDispatch Devolve a interface da IDispatch fonte.
CFontHolder::GetFontHandle Devolve um handle a uma fonte Windows.
CFontHolder::InitializeFont Inicializa um CFontHolder objeto.
CFontHolder::QueryTextMetrics Recupera informações para a fonte relacionada.
CFontHolder::ReleaseFont Desliga o CFontHolder objeto das IFont interfaces de and IFontNotification .
CFontHolder::Select Seleciona um recurso de fonte no contexto de um dispositivo.
CFontHolder::SetFont Liga o CFontHolder objeto a uma IFont interface.

Membros de Dados Públicos

Nome Description
CFontHolder::m_pFont Um apontador para a CFontHolder interface do IFont objeto.

Observações

CFontHolder não tem uma classe base.

Use esta classe para implementar propriedades de fonte personalizadas para o seu controlo. Para informações sobre como criar tais propriedades, consulte o artigo Controlos ActiveX: Utilização de Fontes.

Hierarquia de herança

CFontHolder

Requerimentos

Cabeçalho: afxctl.h

CFontHolder::CFontHolder

Constrói um CFontHolder objeto.

explicit CFontHolder(LPPROPERTYNOTIFYSINK pNotify);

Parâmetros

pNotify
Apontador para a interface da IPropertyNotifySink fonte.

Observações

Deve chamar InitializeFont para inicializar o objeto resultante antes de o usar.

CFontHolder::GetDisplayString

Recupera uma string que pode ser exibida no navegador de propriedades de um contentor.

BOOL GetDisplayString(CString& strValue);

Parâmetros

strValue
Referência ao CString que serve para segurar a cadeia de visualização.

Valor de retorno

Não nula se a corda for recuperada com sucesso; caso contrário, 0.

CFontHolder::GetFontDispatch

Chame esta função para recuperar um ponteiro para a interface de despacho da fonte.

LPFONTDISP GetFontDispatch();

Valor de retorno

Um apontador para a CFontHolder interface do IFontDisp objeto. Note que a função que chama GetFontDispatch deve chamar IUnknown::Release este ponteiro de interface quando terminar com ele.

Observações

Ligue InitializeFont antes de ligar GetFontDispatchpara .

CFontHolder::GetFontHandle

Chame esta função para obter um handle de uma fonte do Windows.

HFONT GetFontHandle();

HFONT GetFontHandle(
    long cyLogical,
    long cyHimetric);

Parâmetros

cyLogical
Altura, em unidades lógicas, do retângulo onde o controlo é desenhado.

ciHimétrico
Altura, em MM_HIMETRIC unidades, do controlo.

Valor de retorno

Um handle para o objeto Font; caso contrário, NULL.

Observações

A razão entre cyLogical e cyHimetric é usada para calcular o tamanho adequado do ecrã, em unidades lógicas, para o tamanho de pontos da fonte expresso em MM_HIMETRIC unidades:

Tamanho do ecrã = ( cyLogical / cyHimetric) X tamanho da fonte

A versão sem parâmetros devolve um handle para uma fonte com o tamanho correto para o ecrã.

CFontHolder::InitializeFont

Inicializa um CFontHolder objeto.

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

Parâmetros

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

pFontDispAmbient
Apontador para a propriedade ambiente Font do contentor.

Observações

Se o pFontDispAmbient não for NULL, o CFontHolder objeto está ligado a um clone da IFont interface usada pela propriedade ambiente Font do contentor.

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

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

CFontHolder::m_pFont

Um apontador para a CFontHolder interface do IFont objeto.

LPFONT m_pFont;

CFontHolder::QueryTextMetrics

Recupera informação sobre a fonte física representada pelo CFontHolder objeto.

void QueryTextMetrics(LPTEXTMETRIC lptm);

Parâmetros

LPTM
Um apontador para uma estrutura TEXTMÉTRICA que irá receber a informação.

CFontHolder::ReleaseFont

Esta função desconecta o CFontHolder objeto da sua IFont interface.

void ReleaseFont();

CFontHolder::Select

Chame esta função para selecionar a fonte do seu controlo no contexto especificado do dispositivo.

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

Parâmetros

pDC
Contexto do dispositivo no qual a fonte é selecionada.

cyLogical
Altura, em unidades lógicas, do retângulo onde o controlo é desenhado.

ciHimétrico
Altura, em MM_HIMETRIC unidades, do controlo.

Valor de retorno

Um apontador para a fonte que está a ser substituída.

Observações

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

CFontHolder::SetFont

Liberta qualquer fonte existente e liga o CFontHolder objeto a uma IFont interface.

void SetFont(LPFONT pNewFont);

Parâmetros

pNewFont
Aponta para a nova IFont interface.

Consulte também

Gráfico de Hierarquia
Classe CPropExchange

  • Last updated on