MÉTHODE IDWriteFontSet1 ::GetFilteredFonts(DWRITE_FONT_AXIS_RANGEconst*,UINT32,BOOL,IDWriteFontSet1**) (dwrite_3.h)

Récupère un sous-ensemble de polices filtrées par les plages données, y compris les points de terminaison.

Syntaxe

HRESULT GetFilteredFonts(
        DWRITE_FONT_AXIS_RANGE const *fontAxisRanges,
        UINT32                       fontAxisRangeCount,
        BOOL                         selectAnyRange,
  [out] IDWriteFontSet1              **filteredFontSet
);

Paramètres

fontAxisRanges

Type : DWRITE_FONT_AXIS_RANGE const *

Liste des plages de valeurs d’axe à filtrer.

fontAxisRangeCount

Type : UINT32

Nombre de plages de valeurs d’axe à filtrer.

selectAnyRange

Type : BOOL

true si GetFilteredFonts doit sélectionner une plage ; false s’il doit sélectionner l’intersection de tous.

[out] filteredFontSet

Type : IDWriteFontSet1**

Adresse d’un pointeur vers une interface IDWriteFontSet1 . En cas de réussite de l’exécution, la fonction définit le pointeur vers un objet représentant le sous-ensemble de polices qui se trouvent dans les plages, sinon elle définit le pointeur sur nullptr.

Valeur retournée

Type : HRESULT

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

Remarques

Si aucune police ne correspond au filtre, l’objet de sous-ensemble retourné est vide (l’appel de IDWriteFontSet ::GetFontCount renvoie 0), mais la fonction ne retourne pas d’erreur. Le sous-ensemble est toujours égal ou inférieur à l’ensemble d’origine.

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