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.