IDWriteFontSetBuilder2::AddFont-Methode (dwrite_3.h)

Fügt dem zu erstellenden Satz eine Schriftart hinzu, wobei der Aufrufer genügend Informationen zum Suchen und Bestimmen von Achsenbereichen liefert, sodass die potenziell nicht lokale Schriftart nicht geöffnet werden muss.

Syntax

HRESULT AddFont(
  IDWriteFontFile              *fontFile,
  UINT32                       fontFaceIndex,
  DWRITE_FONT_SIMULATIONS      fontSimulations,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  DWRITE_FONT_AXIS_RANGE const *fontAxisRanges,
  UINT32                       fontAxisRangeCount,
  DWRITE_FONT_PROPERTY const   *properties,
  UINT32                       propertyCount
);

Parameter

fontFile

Typ: IDWriteFontFile*

Schriftdateiverweisobjekt, das dem Satz hinzugefügt werden soll.

fontFaceIndex

Typ: UINT32

Der nullbasierte Index einer Schriftart in einer Auflistung.

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.

fontAxisRanges

Typ: DWRITE_FONT_AXIS_RANGE const *

Liste der Achsenbereiche.

fontAxisRangeCount

Typ: UINT32

Anzahl der Achsenbereiche.

properties

Typ: DWRITE_FONT_PROPERTY const *

Liste der Eigenschaften, die dem Verweis zugeordnet werden sollen.

propertyCount

Typ: UINT32

Die Anzahl der definierten Eigenschaften.

Rückgabewert

Typ: HRESULT

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

Hinweise

Die Schriftarteigenschaften sollten mindestens eine Familie (typografisch oder Gewicht/Stil/Stretch) enthalten. Andernfalls kann auf die Schriftart im IDWriteFontSet nur über den Index und nicht über den Namen zugegriffen werden.

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