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

Récupère une liste de polices dans la famille de polices spécifiée, classée dans l’ordre où elles correspondent bien aux 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 n’est pas sensible à 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 (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.

[out] fontList

Type : IDWriteFontList2**

Adresse d’un pointeur vers une interface IDWriteFontList2. Une fois l’achèvement réussi, la fonction définit le pointeur sur un objet de liste de polices nouvellement créé.

Valeur de retour

Type : HRESULT

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

Remarques

Si aucune police ne correspond, un objet de liste vide est retourné (en appelant IDWriteFontList ::GetFontCount sur celui-ci retourne 0), mais la fonction ne retourne pas d’erreur.

Exigences