IDWriteFontResource::CreateFontFace-Methode (dwrite_3.h)

Artikel
08/23/2023

Erstellt ein Schriftzeichen instance 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

Schriftzeichensimulationsflags für algorithmische Verschönerung und Kursivisierung.

fontAxisValues

Typ: DWRITE_FONT_AXIS_VALUE const *

Ein Zeiger auf ein Array, das eine Liste von Schriftartachsenwerten 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 Schriftartachsenwerte.

[out] fontFace

Typ: IDWriteFontFace5**

Die Adresse eines Zeigers auf eine IDWriteFontFace5-Schnittstelle . Nach erfolgreicher Vervollständigung 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, gibt sie S_OK zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Rückgabewert	BESCHREIBUNG
DWRITE_E_REMOTEFONT	Die Schriftart ist nicht lokal.

Hinweise

Die von Ihnen angegebenen Achsenwerte dürfen eine Teilmenge oder Übermenge aller tatsächlich von der Schriftart unterstützten Werte sein. Alle nicht spezifizierten Achsen verwenden ihre Standardwerte: Werte außerhalb der Bereiche werden geklemmt, und alle nicht variierenden Achsen haben keine Auswirkung.

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