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

Weitere Informationen

IDWriteFactory