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 retorno
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 retorno
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 retorno
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 retorno
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.