IDWriteFontSetBuilder2 ::AddFont, méthode (dwrite_3.h)

Ajoute une police au jeu généré, avec l’appelant fournissant suffisamment d’informations pour rechercher et déterminer les plages d’axe, ce qui évite d’avoir à ouvrir la police potentiellement non locale.

Syntaxe

HRESULT AddFont(
  IDWriteFontFile              *fontFile,
  UINT32                       fontFaceIndex,
  DWRITE_FONT_SIMULATIONS      fontSimulations,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  DWRITE_FONT_AXIS_RANGE const *fontAxisRanges,
  UINT32                       fontAxisRangeCount,
  DWRITE_FONT_PROPERTY const   *properties,
  UINT32                       propertyCount
);

Paramètres

fontFile

Type : IDWriteFontFile*

Objet de référence de fichier de police à ajouter à l’ensemble.

fontFaceIndex

Type : UINT32

Index de base zéro d’un visage de police dans une collection.

fontSimulations

Type : DWRITE_FONT_SIMULATIONS

Indicateurs de simulation de visage de police pour l’emboldenisation algorithmique et l’italique.

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.

fontAxisRanges

Type : DWRITE_FONT_AXIS_RANGE const *

Liste des plages d’axe.

fontAxisRangeCount

Type : UINT32

Nombre de plages d’axe.

properties

Type : DWRITE_FONT_PROPERTY const *

Liste des propriétés à associer à la référence.

propertyCount

Type : UINT32

Nombre de propriétés définies.

Valeur de retour

Type : HRESULT

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

Remarques

Les propriétés de police doivent inclure au moins une famille (typographique ou weight/style/stretch). Sinon, la police serait accessible dans le IDWriteFontSet uniquement par index, et non par nom.

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