IDWriteFactory6::CreateTextFormat-Methode (dwrite_3.h)

Artikel
02/29/2024

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 Sammlung.

fontCollection

Typ: IDWriteFontCollection*

Schriftartsammlung. Verwenden Sie nullptr , um die Systemschriftartensammlung anzugeben.

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.

fontSize

Typ: FLOAT

Logische Größe 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 . Nach erfolgreicher Vervollständigung 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, gibt sie S_OK zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Wenn fontCollection ist nullptr, wird die Systemschriftartensammlung verwendet, gruppiert nach typografischem Familiennamen (DWRITE_FONT_FAMILY_MODEL_TYPOGRAPHIC) ohne herunterladbare Schriftarten.

Anforderungen

Anforderung	Wert
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