IDWriteFactory::CreateTextFormat-Methode (dwrite.h)

  • Artikel

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

Syntax

HRESULT CreateTextFormat(
  [in]  WCHAR const           *fontFamilyName,
        IDWriteFontCollection *fontCollection,
        DWRITE_FONT_WEIGHT    fontWeight,
        DWRITE_FONT_STYLE     fontStyle,
        DWRITE_FONT_STRETCH   fontStretch,
        FLOAT                 fontSize,
  [in]  WCHAR const           *localeName,
  [out] IDWriteTextFormat     **textFormat
);

Parameter

[in] fontFamilyName

Typ: const WCHAR*

Ein Zeichenarray, das den Namen der Schriftfamilie enthält

fontCollection

Typ: IDWriteFontCollection*

Ein Zeiger auf ein Schriftartsammlungsobjekt. Wenn dies NULL ist, gibt die Systemschriftartensammlung an.

fontWeight

Typ: DWRITE_FONT_WEIGHT

Ein Wert, der die Schriftstärke für das mit dieser Methode erstellte Textobjekt angibt.

fontStyle

Typ: DWRITE_FONT_STYLE

Ein Wert, der die Schriftart für das textobjekt angibt, das von dieser Methode erstellt wurde.

fontStretch

Typ: DWRITE_FONT_STRETCH

Ein Wert, der den Schriftgrad für das von dieser Methode erstellte Textobjekt angibt.

fontSize

Typ: FLOAT

Die logische Größe der Schriftart in DIP-Einheiten ("geräteunabhängiges Pixel"). Ein DIP entspricht 1/96 Zoll.

[in] localeName

Typ: const WCHAR*

Ein Array von Zeichen, das den Gebietsschemanamen enthält.

[out] textFormat

Typ: IDWriteTextFormat**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf ein neu erstelltes Textformatobjekt oder NULL im Falle eines Fehlers.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile dwrite.h
Bibliothek Dwrite.lib
DLL Dwrite.dll

Weitere Informationen

IDWriteFactory