IDWriteFontResource::CreateFontFace-Methode (dwrite_3.h)

Artikel
07/16/2024

Erstellt eine Schriftart-Gesichtsinstanz mit bestimmten Achsenwerten.

Syntax

HRESULT CreateFontFace(
        DWRITE_FONT_SIMULATIONS      fontSimulations,
        DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
        UINT32                       fontAxisValueCount,
  [out] IDWriteFontFace5             **fontFace
);

Parameter

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] fontFace

Typ: IDWriteFontFace5**

Die Adresse eines Zeigers auf eine IDWriteFontFace5 Schnittstelle. Nach erfolgreichem Abschluss legt die Funktion den Zeiger auf ein neu erstelltes Schriftzeichenobjekt 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.

Rückgabewert	Beschreibung
DWRITE_E_REMOTEFONT	Die Schriftart ist nicht lokal.

Bemerkungen

Die von Ihnen bereitgestellten Achsenwerte dürfen eine Teilmenge oder Eine Obermenge aller elemente sein, die tatsächlich von der Schriftart unterstützt werden. Alle nicht angegebenen Achsen verwenden ihre Standardwerte: Werte, die über die Bereiche hinausgehen, werden geklemmt, und alle nicht variierenden Achsen haben keine Auswirkung.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10 Build 20348
mindestens unterstützte Server-	Windows 10 Build 20348
Zielplattform-	Fenster
Header-	dwrite_3.h
Library	Dwrite.lib

Freigeben über