IDWriteFactory::CreateTextLayout-Methode (dwrite.h)
Verwendet eine Zeichenfolge, ein Textformat und zugeordnete Einschränkungen und erzeugt ein -Objekt, das das vollständig analysierte und formatierte Ergebnis darstellt.
Syntax
HRESULT CreateTextLayout(
[in] WCHAR const *string,
UINT32 stringLength,
IDWriteTextFormat *textFormat,
FLOAT maxWidth,
FLOAT maxHeight,
[out] IDWriteTextLayout **textLayout
);
Parameter
[in] string
Typ: const WCHAR*
Ein Array von Zeichen, das die Zeichenfolge enthält, aus der ein neues IDWriteTextLayout-Objekt erstellt werden soll. Dieses Array muss die Länge stringLength aufweisen und kann eingebettete NULL-Zeichen enthalten.
stringLength
Typ: UINT32
Die Anzahl der Zeichen in der Zeichenfolge.
textFormat
Typ: IDWriteTextFormat*
Ein Zeiger auf ein -Objekt, das das Format angibt, das auf die Zeichenfolge angewendet werden soll.
maxWidth
Typ: FLOAT
Die Breite des Layoutfelds.
maxHeight
Typ: FLOAT
Die Höhe des Layoutfelds.
[out] textLayout
Typ: IDWriteTextLayout**
Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf das resultierende Textlayoutobjekt.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |