Interface IFont (ocidl.h)

Fournit un wrapper autour d’un objet de police Windows. L’objet de police COM prend en charge un certain nombre de propriétés en lecture/écriture, ainsi qu’un ensemble de méthodes via son interface IFont . Il prend en charge le même ensemble de propriétés (mais pas les méthodes) via l’interface de répartition IFontDisp, qui est dérivée d’IDispatch pour fournir l’accès aux propriétés de la police via Automation. Le système fournit une implémentation standard de l’objet police avec les deux interfaces.

L’objet police prend également en charge l’interface sortante IPropertyNotifySink afin qu’un client puisse déterminer quand les propriétés de police changent. Étant donné que l’objet police prend en charge au moins une interface sortante, il implémente également IConnectionPointContainer et les interfaces associées à cet effet.

L’objet police fournit une propriété hFont, qui est un handle de police Windows conforme aux autres attributs spécifiés pour la police. L’objet police retarde la réalisation de cet objet hFont dans la mesure du possible. Par conséquent, la définition consécutive de deux propriétés sur une police n’entraîne pas la réalisation d’une police intermédiaire. En outre, en tant qu’optimisation, l’objet police implémentée par le système gère un cache de poignées de police. Deux objets de police dans le même processus qui ont des propriétés identiques retournent le même handle de police. L’objet police peut supprimer des handles de police de ce cache à volonté, ce qui introduit des considérations spéciales pour les clients utilisant la propriété hFont.

L’objet police prend également en charge IPersistStream afin qu’il puisse enregistrer et se charger lui-même à partir d’un instance d’IStream. Un objet qui utilise un objet police en interne enregistre et charge normalement la police dans le cadre de la gestion de la persistance de l’objet.

En outre, l’objet police prend en charge IDataObject, qui peut afficher un jeu de propriétés contenant les attributs de la police, ce qui permet à un client d’enregistrer ces propriétés sous forme de texte.

Héritage

L’interface IFont hérite de l’interface IUnknown. IFont a également les types de membres suivants :

Méthodes

L’interface IFont possède ces méthodes.

IFont::AddRefHfont Avertit l’objet police que la police précédemment réalisée identifiée avec hFont doit rester valide jusqu’à ce que ReleaseHfont soit appelé ou que l’objet police lui-même soit complètement libéré.
IFont::Clone Crée un objet de police en double.
IFont::get_Bold Obtient la propriété Bold actuelle de la police.
IFont::get_Charset Récupère le jeu de caractères utilisé dans la police.
IFont::get_hFont Récupère un handle de la police décrite par cet objet de police.
IFont::get_Italic Obtient la propriété italique actuelle de la police.
IFont::get_Name Récupère le nom de la famille de polices.
IFont::get_Size Récupère la taille de point de la police.
IFont::get_Strikethrough Obtient la propriété Strikethrough actuelle de la police.
IFont::get_Underline Obtient la propriété Soulignement actuelle de la police.
IFont::get_Weight Obtient la propriété Weight actuelle de la police.
IFont::IsEqual Compare cet objet de police à un autre pour l’équivalence.
IFont::p ut_Bold Définit la propriété Bold de la police.
IFont::p ut_Charset Définit le jeu de caractères de la police.
IFont::p ut_Italic Définit la propriété italique de la police.
IFont::p ut_Name Spécifie un nouveau nom pour la famille de polices.
IFont::p ut_Size Définit la taille de point de la police.
IFont::p ut_Strikethrough Définit la propriété Strikethrough de la police.
IFont::p ut_Underline Définit la propriété Soulignement de la police.
IFont::p ut_Weight Définit la propriété Weight de la police.
IFont::QueryTextMetrics Remplit une structure allouée à l’appelant avec des informations sur la police.
IFont::ReleaseHfont Avertit l’objet police que l’appelant qui a précédemment verrouillé cette police dans le cache avec IFont::AddRefHfont n’a plus besoin du verrou.
IFont::SetHdc Fournit un contexte d’appareil à la police qui décrit le mode de mappage logique.
IFont::SetRatio Convertit le facteur de mise à l’échelle de cette police entre les unités logiques et les unités HIMETRIC.

Notes

Chaque propriété de l’interface IFont inclut une méthode get_PropertyName si la propriété prend en charge l’accès en lecture et une méthode put_PropertyName si la propriété prend en charge l’accès en écriture. La plupart de ces propriétés prennent en charge l’accès en lecture et en écriture.

Propriété	Type	Read Access, méthode	Write Access, méthode	Description
Nom	BSTR	get_Name	put_Name	Nom de visage de la police, par exemple Arial.
Taille	CY	get_Size	put_Size	Taille de point de la police, exprimée dans un type CY pour autoriser les tailles de points fractionnaires.
Gras	BOOL	get_Bold	put_Bold	Indique si la police est en gras.
Italique	BOOL	get_Italic	put_Italic	Indique si la police est en italique.
Souligner	BOOL	get_Underline	put_Underline	Indique si la police est soulignée.
Barré	BOOL	get_Strikethrough	put_Strikethrough	Indique si la police est barrée.
Poids	short	get_Weight	put_Weight	Gras de la police.
Charset	short	get_Charset	put_Charset	Jeu de caractères utilisé dans la police, tel que ANSI_CHARSET, DEFAULT_CHARSET ou SYMBOL_CHARSET.
hFont	HFONT	get_hFont		Handle de police Windows qui peut être sélectionné dans un contexte d’appareil pour le rendu.

 

Implémentation OLE

Le système fournit une implémentation standard d’un objet de police avec l’interface IFont en plus de la prise en charge des polices système sous-jacentes. Un objet de police est créé via la fonction OleCreateFontIndirect. Un objet de police prend en charge un certain nombre de propriétés en lecture/écriture ainsi qu’un ensemble de méthodes via son interface IFont et prend en charge le même ensemble de propriétés (mais pas les méthodes) via une interface de répartition IFontDisp dérivée d’IDispatch pour fournir l’accès aux propriétés de la police via Automation. L’implémentation système de l’objet de police fournit les deux interfaces.

Spécifications

Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	ocidl.h

Voir aussi

IFontDisp