IDWriteFactory::CreateGdiCompatibleTextLayout-Methode (dwrite.h)

Verwendet eine Zeichenfolge, ein Format und zugehörige Einschränkungen und erzeugt ein Objekt, das das Ergebnis darstellt, das für eine bestimmte Anzeigeauflösung und einen bestimmten Messmodus formatiert ist.

Syntax

HRESULT CreateGdiCompatibleTextLayout(
  [in]           WCHAR const         *string,
                 UINT32              stringLength,
                 IDWriteTextFormat   *textFormat,
                 FLOAT               layoutWidth,
                 FLOAT               layoutHeight,
                 FLOAT               pixelsPerDip,
  [in, optional] DWRITE_MATRIX const *transform,
                 BOOL                useGdiNatural,
  [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 Länge der Zeichenfolge in Zeichenanzahl.

textFormat

Typ: IDWriteTextFormat*

Das Textformatierungsobjekt, das auf die Zeichenfolge angewendet werden soll.

layoutWidth

Typ: FLOAT

Die Breite des Layoutfelds.

layoutHeight

Typ: FLOAT

Die Höhe des Layoutfelds.

pixelsPerDip

Typ: FLOAT

Die Anzahl der physischen Pixel pro DIP (geräteunabhängiges Pixel). Beispiel: Rendern auf einem 96 DPI-GerätepixelPerDip ist 1. Beim Rendern auf einem Gerät mit 120 DPI ist Die PixelperDip 1,25 (120/96).

[in, optional] transform

Typ: const DWRITE_MATRIX*

Eine optionale Transformation, die auf die Glyphen und deren Positionen angewendet wird. Diese Transformation wird angewendet, nachdem die Skalierung den Schriftgrad und die Pixel pro DIP angegeben hat.

useGdiNatural

Typ: BOOL

Weist das Textlayout an, dieselben Metriken wie GDI-Text auf zwei Ebenen zu verwenden, wenn es auf FALSE festgelegt ist. Weist bei Festlegung auf TRUE das Textlayout an, die gleichen Metriken wie text zu verwenden, der von GDI mithilfe einer Schriftart gemessen wird , die mit CLEARTYPE_NATURAL_QUALITY erstellt wurde.

[out] textLayout

Typ: IDWriteTextLayout**

Wenn diese Methode zurückgibt, enthält eine Adresse auf den Zeiger des resultierenden Textlayoutobjekts.

Rückgabewert

Typ: HRESULT

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

Hinweise

Das resultierende Textlayout sollte nur für die beabsichtigte Auflösung verwendet werden, und für Fälle, in denen die Textskalierbarkeit gewünscht ist, sollte stattdessen CreateTextLayout verwendet werden.

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