IDWriteFactory::CreateTextFormat-Methode (dwrite.h)
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 |