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 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 nullptr
festgelegt.
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 |