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