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

Article
11/20/2024

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

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

Partager via