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 20348
serveur minimum pris en charge	Windows 10 Build 20348
plateforme cible	Windows
d’en-tête	dwrite_3.h
bibliothèque	Dwrite.lib