MÉTHODE IDWriteFontSet ::GetMatchingFonts(WCHARconst*,DWRITE_FONT_WEIGHT,DWRITE_FONT_STRETCH,DWRITE_FONT_STYLE,IDWriteFontSet**) (dwrite_3.h)

Article
03/01/2024

Retourne un sous-ensemble de polices filtrées par les propriétés données.

Syntaxe

HRESULT GetMatchingFonts(
  WCHAR const         *familyName,
  DWRITE_FONT_WEIGHT  fontWeight,
  DWRITE_FONT_STRETCH fontStretch,
  DWRITE_FONT_STYLE   fontStyle,
  IDWriteFontSet      **filteredSet
);

Paramètres

familyName

Nom de la famille de polices.

fontWeight

Poids de police.

fontStretch

Valeur stretch de police.

fontStyle

Style de police.

filteredSet

Type : [out] IDWriteFontSet**

Sous-ensemble de polices qui correspondent aux propriétés, ou nullptr en cas d’échec.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Si aucune police ne correspond au filtre, le sous-ensemble est vide (GetFontCount retourne 0), mais la fonction ne retourne pas d’erreur. Le sous-ensemble sera toujours égal ou inférieur à l’ensemble d’origine. Si vous souhaitez filtrer uniquement les polices distantes, vous pouvez passer null dans les propriétés et zéro dans propertyCount.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 (applications de bureau uniquement)
Serveur minimal pris en charge	Windows Server 2016 (applications de bureau uniquement)
Plateforme cible	Windows
En-tête	dwrite_3.h
Bibliothèque	Dwrite.lib
DLL	Dwrite.dll

Voir aussi

IDWriteFontSet

Partager via