IDWriteFactory6::CreateFontFaceReference-Methode (dwrite_3.h)

Erstellt einen Verweis auf eine bestimmte Schriftartinstanz 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 Schriftzeichens in Fällen, in denen die Schriftartdatei eine Sammlung von Schriftartenbeschriftung enthält. Wenn die Schriftartdatei ein einzelnes Gesicht enthält, legen Sie diesen Wert auf Null fest.

fontSimulations

Typ: DWRITE_FONT_SIMULATIONS

Font face simulation flags for algorithmic emboldening and italicization.

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) sein, die durch das argument fontAxisValueCount angegeben ist.

fontAxisValueCount

Typ: UINT32-

Die Anzahl der Schriftachsenwerte, die in der fontAxisValues Array enthalten sind.

[out] fontFaceReference

Typ: IDWriteFontFaceReference1**

Die Adresse eines Zeigers auf eine IDWriteFontFaceReference1 Schnittstelle. Nach erfolgreichem Abschluss legt die Funktion den Zeiger auf ein neu erstelltes Schriftart-Gesichtsbezugsobjekt fest, andernfalls wird der Zeiger auf nullptrfestgelegt.

Rückgabewert

Typ: HRESULT-

Wenn die Funktion erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT-Fehlercodezurückgegeben.

Anforderungen