IDWriteFontSetBuilder2::AddFont-Methode (dwrite_3.h)

Fügt dem zu erstellenden Satz eine Schriftart hinzu, wobei der Aufrufer genügend Informationen zum Suchen nach und Bestimmen von Achsenbereichen liefert, ohne die Notwendigkeit zu öffnen, die potenziell nicht lokale Schriftart zu öffnen.

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*

Schriftartdateiverweisobjekt, das dem Satz hinzugefügt werden soll.

fontFaceIndex

Typ: UINT32-

Der nullbasierte Index einer Schriftart in einer Auflistung.

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.

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, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT-Fehlercodezurückgegeben.

Bemerkungen

Die Schriftarteigenschaften sollten mindestens eine Familie enthalten (Typografie oder Stärke/Format/Stretch). Andernfalls kann auf die Schriftart im IDWriteFontSet zugegriffen werden, nur nach Index, nicht nach Name.

Anforderungen