IDWriteFontSet1 ::GetMatchingFonts, méthode (dwrite_3.h)
Récupère un jeu de polices correspondant en fonction des entrées demandées, ordonné afin que les correspondances plus proches soient antérieures.
Syntaxe
HRESULT GetMatchingFonts(
DWRITE_FONT_PROPERTY const *fontProperty,
DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
UINT32 fontAxisValueCount,
IDWriteFontSet1 **matchingFonts
);
Paramètres
fontProperty
Type : DWRITE_FONT_PROPERTY const *
Propriété de police intéressante, telle que la famille typographique ou la famille de poids/stretch/style.
fontAxisValues
Type : DWRITE_FONT_AXIS_VALUE const *
Pointeur vers un tableau contenant une liste de valeurs d’axe de police. Le tableau doit être la taille (le nombre d’éléments) indiquée par l’argument fontAxisValueCount.
fontAxisValueCount
Type : UINT32
Nombre de valeurs d’axe de police contenues dans le tableau fontAxisValues.
matchingFonts
Type : IDWriteFontSet1**
Adresse d’un pointeur vers une interface IDWriteFontSet1. Une fois l’achèvement réussi, la fonction définit le pointeur sur une liste hiérarchisée de polices qui correspondent aux propriétés, sinon elle définit le pointeur sur nullptr
.
Valeur de retour
Type : HRESULT
Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Cette méthode peut générer des éléments distincts qui n’étaient pas dans le jeu de polices d’origine, y compris les éléments avec des indicateurs de simulation (s’ils seraient plus proches de la demande) et des instances qui n’ont pas été nommées par l’auteur de police. Les éléments des mêmes ressources de police sont réduits en un : la correspondance la plus proche possible.
Exigences
Exigence | Valeur |
---|---|
client minimum pris en charge | Windows 10 Build 16299 |
serveur minimum pris en charge | Windows 10 Build 16299 |
plateforme cible | Windows |
d’en-tête | dwrite_3.h |
bibliothèque | Dwrite.lib |