IDWriteFontCollection2 ::GetMatchingFonts, méthode (dwrite_3.h)

Récupère une liste de polices dans la famille de polices spécifiée, classée par ordre de correspondance avec les valeurs d’axe spécifiées.

Syntaxe

HRESULT GetMatchingFonts(
        WCHAR const                  *familyName,
        DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
        UINT32                       fontAxisValueCount,
  [out] IDWriteFontList2             **fontList
);

Paramètres

familyName

Type : WCHAR const *

Nom de la famille de polices. Le nom ne respecte pas la casse, mais doit correspondre exactement à un nom de famille dans la collection.

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 (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 .

[out] fontList

Type : IDWriteFontList2**

Adresse d’un pointeur vers une interface IDWriteFontList2 . Une fois l’exécution réussie, la fonction définit le pointeur vers un objet de liste de polices nouvellement créé.

Valeur retournée

Type : HRESULT

Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreurHRESULT.

Remarques

Si aucune police ne correspond, un objet de liste vide est retourné (l’appel de IDWriteFontList ::GetFontCount renvoie 0), mais la fonction ne retourne pas d’erreur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 Build 20348
Serveur minimal pris en charge	Windows 10 Build 20348
Plateforme cible	Windows
En-tête	dwrite_3.h
Bibliothèque	Dwrite.lib