IDWriteFactory::CreateFontFace-Methode (dwrite.h)

Erstellt ein -Objekt, das eine Schriftart darstellt.

Syntax

HRESULT CreateFontFace(
        DWRITE_FONT_FACE_TYPE   fontFaceType,
        UINT32                  numberOfFiles,
  [in]  IDWriteFontFile         * const *fontFiles,
        UINT32                  faceIndex,
        DWRITE_FONT_SIMULATIONS fontFaceSimulationFlags,
  [out] IDWriteFontFace         **fontFace
);

Parameter

fontFaceType

Typ: DWRITE_FONT_FACE_TYPE

Ein Wert, der den Typ des Dateiformats des Schriftzeichens angibt.

numberOfFiles

Typ: UINT32

Die Anzahl der Schriftartdateien in der Elementanzahl, die zum Darstellen des Schriftbilds erforderlich ist.

[in] fontFiles

Typ: const IDWriteFontFile*

Ein Schriftdateiobjekt, das die Schriftfarbe darstellt. Da IDWriteFontFace eigene Verweise auf die Eingabeschriftdateiobjekte verwaltet, können Sie diese nach diesem Aufruf freigeben.

faceIndex

Typ: UINT32

Der nullbasierte Index eines Schriftartgesichts, in Fällen, in denen die Schriftartdateien eine Sammlung von Schriftflächen enthalten. Wenn die Schriftartdateien ein einzelnes Gesicht enthalten, sollte dieser Wert 0 sein.

fontFaceSimulationFlags

Typ: DWRITE_FONT_SIMULATIONS

Ein Wert, der angibt, welche, falls vorhanden, Schriftarten-Gesichtserkennungsflags für algorithmische Mittel zum Fett- oder Kursivmachen von Text auf die aktuelle Schriftartseite angewendet werden.

[out] fontFace

Typ: IDWriteFontFace**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf das neu erstellte Schriftzeichenobjekt oder NULL im Falle eines Fehlers.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Weitere Informationen

IDWriteFactory