Classe CFontHolder

Implementa la proprietà predefinita e incapsula la funzionalità di un oggetto tipo di carattere di Windows e l'interfaccia IFont .

Sintassi

class CFontHolder

Membri

Costruttori pubblici

Nome	Descrizione
CFontHolder::CFontHolder	Costruisce un oggetto CFontHolder.

Metodi pubblici

Nome	Descrizione
CFontHolder::GetDisplayString	Recupera la stringa visualizzata nel browser delle proprietà di un contenitore.
CFontHolder::GetFontDispatch	Restituisce l'interfaccia del tipo di IDispatch carattere.
CFontHolder::GetFontHandle	Restituisce un handle a un tipo di carattere di Windows.
CFontHolder::InitializeFont	Inizializza un oggetto CFontHolder.
CFontHolder::QueryTextMetrics	Recupera informazioni per il tipo di carattere correlato.
CFontHolder::ReleaseFont	Disconnette l'oggetto CFontHolder dalle IFont interfacce e IFontNotification .
CFontHolder::Select	Seleziona una risorsa tipo di carattere in un contesto di dispositivo.
CFontHolder::SetFont	Connessione l'oggetto a un'interfaccia CFontHolderIFont.

Membri dati pubblici

Nome	Descrizione
CFontHolder::m_pFont	Puntatore all'interfaccia CFontHolder dell'oggetto IFont .

Osservazioni:

CFontHolder non dispone di una classe di base.

Utilizzare questa classe per implementare proprietà personalizzate del tipo di carattere per il controllo. Per informazioni sulla creazione di tali proprietà, vedere l'articolo Controlli ActiveX: Uso dei tipi di carattere.

Gerarchia di ereditarietà

CFontHolder

Requisiti

Intestazione: afxctl.h

CFontHolder::CFontHolder

Costruisce un oggetto CFontHolder.

explicit CFontHolder(LPPROPERTYNOTIFYSINK pNotify);

Parametri

pNotify
Puntatore all'interfaccia del tipo di IPropertyNotifySink carattere.

Osservazioni:

È necessario chiamare InitializeFont per inizializzare l'oggetto risultante prima di usarlo.

CFontHolder::GetDisplayString

Recupera una stringa che può essere visualizzata nel browser delle proprietà di un contenitore.

BOOL GetDisplayString(CString& strValue);

Parametri

strValue
Riferimento a CString che deve contenere la stringa di visualizzazione.

Valore restituito

Diverso da zero se la stringa viene recuperata correttamente; in caso contrario, 0.

CFontHolder::GetFontDispatch

Chiamare questa funzione per recuperare un puntatore all'interfaccia dispatch del tipo di carattere.

LPFONTDISP GetFontDispatch();

Valore restituito

Puntatore all'interfaccia CFontHolder dell'oggetto IFontDisp . Si noti che la funzione che chiama GetFontDispatch deve chiamare IUnknown::Release su questo puntatore di interfaccia al termine dell'operazione.

Osservazioni:

Chiamare prima di InitializeFont chiamare GetFontDispatch.

CFontHolder::GetFontHandle

Chiamare questa funzione per ottenere un handle a un tipo di carattere di Windows.

HFONT GetFontHandle();

HFONT GetFontHandle(
    long cyLogical,
    long cyHimetric);

Parametri

cyLogical
Altezza, in unità logiche, del rettangolo in cui viene disegnato il controllo.

cyHimetric
Altezza, in unità di MM_HIMETRIC, del controllo.

Valore restituito

Handle per l'oggetto Font; in caso contrario NULL.

Osservazioni:

Il rapporto tra cyLogical e cyHimetric viene usato per calcolare le dimensioni di visualizzazione appropriate, in unità logiche, per le dimensioni del punto del carattere espresse in unità di MM_HIMETRIC:

Dimensioni di visualizzazione = ( cyLogical / cyHimetric) X font size

La versione senza parametri restituisce un handle per un tipo di carattere ridimensionato correttamente per lo schermo.

CFontHolder::InitializeFont

Inizializza un oggetto CFontHolder.

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

Parametri

pFontDesc
Puntatore a una struttura di descrizione del tipo di carattere ( FONTDESC) che specifica le caratteristiche del tipo di carattere.

pFontDispAmbient
Puntatore alla proprietà Font di ambiente del contenitore.

Osservazioni:

Se pFontDispAmbient non è NULL, l'oggetto CFontHolder viene connesso a un clone dell'interfaccia IFont utilizzata dalla proprietà Font di ambiente del contenitore.

Se pFontDispAmbient è NULL, viene creato un nuovo oggetto Font dalla descrizione del tipo di carattere a cui punta pFontDesc oppure, se pFontDesc è NULL, da una descrizione predefinita.

Chiamare questa funzione dopo la costruzione di un CFontHolder oggetto .

CFontHolder::m_pFont

Puntatore all'interfaccia CFontHolder dell'oggetto IFont .

LPFONT m_pFont;

CFontHolder::QueryTextMetrics

Recupera informazioni sul tipo di carattere fisico rappresentato dall'oggetto CFontHolder .

void QueryTextMetrics(LPTEXTMETRIC lptm);

Parametri

lptm
Puntatore a una struttura TEXTMETRIC che riceverà le informazioni.

CFontHolder::ReleaseFont

Questa funzione disconnette l'oggetto CFontHolder dalla relativa IFont interfaccia.

void ReleaseFont();

CFontHolder::Select

Chiamare questa funzione per selezionare il tipo di carattere del controllo nel contesto di dispositivo specificato.

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

Parametri

pDC
Contesto del dispositivo in cui è selezionato il tipo di carattere.

cyLogical
Altezza, in unità logiche, del rettangolo in cui viene disegnato il controllo.

cyHimetric
Altezza, in unità di MM_HIMETRIC, del controllo.

Valore restituito

Puntatore al tipo di carattere da sostituire.

Osservazioni:

Per informazioni sui parametri cyLogical e cyHimetric, vedere GetFontHandle.

CFontHolder::SetFont

Rilascia qualsiasi tipo di carattere esistente e collega l'oggetto a un'interfaccia CFontHolderIFont .

void SetFont(LPFONT pNewFont);

Parametri

pNewFont
Puntatore alla nuova IFont interfaccia.

Vedi anche

Grafico della gerarchia
Classe CPropExchange