Partager via


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 Connecte l’objet CFontHolder à une IFont interface.

Membres de données publics

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

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 CFontHolder IFontDisp . 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 InitializeFont GetFontDispatch.

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 CFontHolder IFont .

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