Partager via

IDWriteFactory6 ::CreateFontFaceReference, méthode (dwrite_3.h)

  • Article

Crée une référence à une instance de police spécifique dans un fichier.

Syntaxe

HRESULT CreateFontFaceReference(
        IDWriteFontFile              *fontFile,
        UINT32                       faceIndex,
        DWRITE_FONT_SIMULATIONS      fontSimulations,
        DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
        UINT32                       fontAxisValueCount,
  [out] IDWriteFontFaceReference1    **fontFaceReference
);

Paramètres

fontFile

Type : IDWriteFontFile*

Fichier de police fourni par l’utilisateur représentant le visage de police.

faceIndex

Type : UINT32

Index de base zéro d’un visage de police dans les cas où le fichier de police contient une collection de visages de police. Si le fichier de police contient un seul visage, définissez cette valeur sur zéro.

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.

[out] fontFaceReference

Type : IDWriteFontFaceReference1**

Adresse d’un pointeur vers une interface IDWriteFontFaceReference1. Une fois l’achèvement réussi, la fonction définit le pointeur sur un objet de référence de visage de police nouvellement créé ; 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.

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