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 | Connette l'oggetto a un'interfaccia CFontHolder IFont . |
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 CFontHolder IFont .
void SetFont(LPFONT pNewFont);
Parametri
pNewFont
Puntatore alla nuova IFont interfaccia.