IDWriteFontSet1 ::GetFilteredFonts(DWRITE_FONT_PROPERTYconst*,UINT32,BOOL,IDWriteFontSet1**) méthode (dwrite_3.h)

Article
07/16/2024

Récupère un sous-ensemble de polices filtrées par les propriétés données.

Syntaxe

HRESULT GetFilteredFonts(
        DWRITE_FONT_PROPERTY const *properties,
        UINT32                     propertyCount,
        BOOL                       selectAnyProperty,
  [out] IDWriteFontSet1            **filteredFontSet
);

Paramètres

properties

Type : DWRITE_FONT_PROPERTY const *

Liste des propriétés à filtrer.

propertyCount

Type : UINT32

Nombre de propriétés à filtrer.

selectAnyProperty

Type : BOOL

true si GetFilteredFontIndices devez sélectionner n’importe quelle propriété ; false si elle doit sélectionner l’intersection de tous.

[out] filteredFontSet

Type : IDWriteFontSet1**

Adresse d’un pointeur vers une interface IDWriteFontSet1. Une fois l’achèvement réussi, la fonction définit le pointeur sur un objet représentant le sous-ensemble de polices qui correspondent aux propriétés ; sinon, il définit le pointeur sur nullptr.

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 au filtre, l’objet de sous-ensemble retourné est vide (l’appel de IDWriteFontSet ::GetFontCount sur celui-ci retourne 0), mais la fonction ne retourne pas d’erreur. Le sous-ensemble est toujours égal ou inférieur au jeu d’origine.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10 Build 20348
serveur minimum pris en charge	Windows 10 Build 20348
plateforme cible	Windows
d’en-tête	dwrite_3.h
bibliothèque	Dwrite.lib

Partager via