IDWriteFactory6::CreateTextFormat-Methode (dwrite_3.h)

Erstellt ein Textformatobjekt, das für das Textlayout verwendet wird.

Syntax

HRESULT CreateTextFormat(
  WCHAR const                  *fontFamilyName,
  IDWriteFontCollection        *fontCollection,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  FLOAT                        fontSize,
  WCHAR const                  *localeName,
  IDWriteTextFormat3           **textFormat
);

Parameter

fontFamilyName

Typ: WCHAR const *

Name der Schriftfamilie aus der Auflistung.

fontCollection

Typ: IDWriteFontCollection*

Schriftartensammlung. Verwenden Sie nullptr, um die Systemschriftartensammlung anzugeben.

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.

fontSize

Typ: FLOAT-

Logischer Schriftgrad der Schriftart in DIP-Einheiten.

localeName

Typ: WCHAR const *

Gebietsschemaname (z. B. "ja-JP", "en-US", "ar-EG").

textFormat

Typ: IDWriteTextFormat3**

Die Adresse eines Zeigers auf eine IDWriteTextFormat3 Schnittstelle. Bei erfolgreicher Fertigstellung legt die Funktion den Zeiger auf ein neu erstelltes Textformatobjekt 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.

Bemerkungen

Wenn fontCollection-nullptrist, wird die Systemschriftsammlung verwendet, gruppiert nach typografischem Familiennamen (DWRITE_FONT_FAMILY_MODEL_TYPOGRAPHIC) ohne herunterladbare Schriftarten.

Anforderungen