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

Article
07/16/2024

Génère un jeu de polices correspondant basé sur les entrées demandées, ordonné afin que les correspondances plus proches soient antérieures.

Syntaxe

HRESULT GetMatchingFonts(
  WCHAR const                  *familyName,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  DWRITE_FONT_SIMULATIONS      allowedSimulations,
  IDWriteFontSet4              **matchingFonts
);

Paramètres

familyName

Type : _In_z_ WCHAR const*

Nom de la famille de polices. Il peut s’agir d’un nom de famille typographique, d’un nom de famille de poids/stretch/style, d’un nom de famille GDI (RBIZ) ou d’un nom complet.

fontAxisValues

Type : _In_reads_(fontAxisValueCount) DWRITE_FONT_AXIS_VALUE const*

Tableau de valeurs d’axe de police.

fontAxisValueCount

Type : UINT32

Nombre de valeurs d’axe de police.

allowedSimulations

Type : DWRITE_FONT_SIMULATIONS

Spécifie les simulations (c’est-à-dire, l’emboldendation algorithmique et/ou l’inclinaison) peuvent être appliquées aux polices correspondantes pour mieux correspondre aux valeurs d’axe spécifiées. Si l’argument est DWRITE_FONT_SIMULATIONS_NONE (0), aucune simulation n’est appliquée.

matchingFonts

Type : _COM_Outptr_ IDWriteFontSet4**

Reçoit un pointeur vers un jeu de polices nouvellement créé, qui contient une liste hiérarchisée de polices qui correspondent aux entrées spécifiées.

Valeur de retour

Type : HRESULT

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

Remarques

Cela peut générer des éléments distincts qui n’étaient pas dans le jeu de polices d’origine, y compris les éléments avec des indicateurs de simulation (s’ils seraient plus proches de la requête) et des instances qui n’ont pas été nommées par l’auteur de police. Les éléments des mêmes ressources de police sont réduits en un : la correspondance la plus proche possible.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 11 Build 22621
d’en-tête	dwrite_3.h
bibliothèque	Dwrite.lib
DLL	Dwrite.dll

Partager via