CFontHolder, classe

Implémente la propriété stock Font et encapsule les fonctionnalités d'un objet police Windows et de l'interface IFont .

Syntaxe

class CFontHolder

Membres

Constructeurs publics

Nom	Description
CFontHolder ::CFontHolder	Construit un objet CFontHolder.

Méthodes publiques

Nom	Description
CFontHolder ::GetDisplayString	Récupère la chaîne affichée dans le navigateur de propriétés d’un conteneur.
CFontHolder ::GetFontDispatch	Retourne l’interface de IDispatch la police.
CFontHolder ::GetFontHandle	Retourne un handle à une police Windows.
CFontHolder ::InitializeFont	Initialise un objet CFontHolder.
CFontHolder ::QueryTextMetrics	Récupère des informations pour la police associée.
CFontHolder ::ReleaseFont	Déconnecte l’objet CFontHolder des interfaces et IFontNotification des IFont interfaces.
CFontHolder ::Select	Sélectionne une ressource de police dans un contexte d’appareil.
CFontHolder ::SetFont	Connecter l’objet CFontHolder à une IFont interface.

Membres de données publics

Nom	Description
CFontHolder ::m_pFont	Pointeur vers l’interface de l’objet CFontHolderIFont .

Notes

CFontHolder n’a pas de classe de base.

Utilisez cette classe pour implémenter des propriétés de police personnalisées pour votre contrôle. Pour plus d’informations sur la création de ces propriétés, consultez l’article Contrôles ActiveX : Utilisation de polices.

Hiérarchie d'héritage

CFontHolder

Spécifications

En-tête : afxctl.h

CFontHolder ::CFontHolder

Construit un objet CFontHolder.

explicit CFontHolder(LPPROPERTYNOTIFYSINK pNotify);

Paramètres

pNotify
Pointeur vers l’interface de IPropertyNotifySink la police.

Notes

Vous devez appeler InitializeFont pour initialiser l’objet résultant avant de l’utiliser.

CFontHolder ::GetDisplayString

Récupère une chaîne qui peut être affichée dans le navigateur de propriétés d’un conteneur.

BOOL GetDisplayString(CString& strValue);

Paramètres

strValue
Référence à la chaîne CString qui doit contenir la chaîne d’affichage.

Valeur de retour

Différent de zéro si la chaîne est récupérée avec succès ; sinon 0.

CFontHolder ::GetFontDispatch

Appelez cette fonction pour récupérer un pointeur vers l’interface de répartition de la police.

LPFONTDISP GetFontDispatch();

Valeur de retour

Pointeur vers l’interface de l’objet CFontHolderIFontDisp . Notez que la fonction qui appelle GetFontDispatch doit appeler IUnknown::Release ce pointeur d’interface lorsqu’elle est terminée.

Notes

Appel avant d’appeler InitializeFontGetFontDispatch.

CFontHolder ::GetFontHandle

Appelez cette fonction pour obtenir un handle vers une police Windows.

HFONT GetFontHandle();

HFONT GetFontHandle(
    long cyLogical,
    long cyHimetric);

Paramètres

cyLogical
Hauteur, en unités logiques, du rectangle dans lequel le contrôle est dessiné.

cyHimetric
Hauteur, en unités MM_HIMETRIC, du contrôle.

Valeur de retour

Handle de l’objet Font ; sinon NULL.

Notes

Le ratio de cyLogical et cyHimetric est utilisé pour calculer la taille d’affichage appropriée, en unités logiques, pour la taille de point de la police exprimée en unités MM_HIMETRIC :

Taille d’affichage = ( cyLogical / cyHimetric) X taille de police

La version sans paramètre retourne un handle à une police correctement dimensionnée pour l’écran.

CFontHolder ::InitializeFont

Initialise un objet CFontHolder.

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

Paramètres

pFontDesc
Pointeur vers une structure de description de police ( FONTDESC) qui spécifie les caractéristiques de la police.

pFontDispAmbient
Pointeur vers la propriété Font ambiante du conteneur.

Notes

Si pFontDispAmbient n’est pas NULL, l’objet CFontHolder est connecté à un clone de l’interface IFont utilisée par la propriété Font ambiante du conteneur.

Si pFontDispAmbient a la valeur NULL, un nouvel objet Font est créé à partir de la description de police pointée par pFontDesc ou, si pFontDesc a la valeur NULL, à partir d’une description par défaut.

Appelez cette fonction après avoir construit un CFontHolder objet.

CFontHolder ::m_pFont

Pointeur vers l’interface de l’objet CFontHolderIFont .

LPFONT m_pFont;

CFontHolder ::QueryTextMetrics

Récupère des informations sur la police physique représentée par l’objet CFontHolder .

void QueryTextMetrics(LPTEXTMETRIC lptm);

Paramètres

lptm
Pointeur vers une structure TEXTMETRIC qui recevra les informations.

CFontHolder ::ReleaseFont

Cette fonction déconnecte l’objet CFontHolder de son IFont interface.

void ReleaseFont();

CFontHolder ::Select

Appelez cette fonction pour sélectionner la police de votre contrôle dans le contexte d’appareil spécifié.

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

Paramètres

pDC
Contexte d’appareil dans lequel la police est sélectionnée.

cyLogical
Hauteur, en unités logiques, du rectangle dans lequel le contrôle est dessiné.

cyHimetric
Hauteur, en unités MM_HIMETRIC, du contrôle.

Valeur de retour

Pointeur vers la police en cours de remplacement.

Notes

Consultez GetFontHandle pour une discussion sur les paramètres cyLogical et cyHimetric .

CFontHolder ::SetFont

Libère toute police existante et connecte l’objet CFontHolder à une IFont interface.

void SetFont(LPFONT pNewFont);

Paramètres

pNewFont
Pointeur vers la nouvelle IFont interface.

Voir aussi

Graphique hiérarchique
CPropExchange, classe