IDWriteFactory6::CreateFontFaceReference-Methode (dwrite_3.h)

Artikel
08/23/2023

Erstellt einen Verweis auf eine bestimmte Schriftart instance in einer Datei.

Syntax

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

Parameter

fontFile

Typ: IDWriteFontFile*

Eine vom Benutzer bereitgestellte Schriftartdatei, die die Schriftart darstellt.

faceIndex

Typ: UINT32

Der nullbasierte Index eines Schriftartengesichts in Fällen, in denen die Schriftartdatei eine Sammlung von Schriftarten enthält. Wenn die Schriftartdatei ein einzelnes Gesicht enthält, legen Sie diesen Wert auf 0 (null) fest.

fontSimulations

Typ: DWRITE_FONT_SIMULATIONS

Schriftartensimulationsflags für algorithmische Verschönerung und Kursivisierung.

fontAxisValues

Typ: DWRITE_FONT_AXIS_VALUE const *

Ein Zeiger auf ein Array, das eine Liste von Schriftachsenwerten enthält. Das Array sollte die Größe (die Anzahl der Elemente) aufweisen, die durch das argument fontAxisValueCount angegeben wird.

fontAxisValueCount

Typ: UINT32

Die Anzahl der Im FontAxisValues-Array enthaltenen Schriftachsenwerte.

[out] fontFaceReference

Typ: IDWriteFontFaceReference1**

Die Adresse eines Zeigers auf eine IDWriteFontFaceReference1-Schnittstelle . Bei erfolgreicher Vervollständigung legt die Funktion den Zeiger auf ein neu erstelltes Verweisobjekt für Schriftarten fest, andernfalls wird der Zeiger auf nullptrfestgelegt.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 10 Build 20348
Unterstützte Mindestversion (Server)	Windows 10 Build 20348
Zielplattform	Windows
Kopfzeile	dwrite_3.h
Bibliothek	Dwrite.lib

Freigeben über