IDWriteFactory::CreateGdiCompatibleTextLayout-Methode (dwrite.h)
Verwendet eine Zeichenfolge, ein Format und zugeordnete 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, um ein neues IDWriteTextLayout-Objekt zu erstellen. Dieses Array muss stringLength- länge sein und kann eingebettete NULL- Zeichen enthalten.
stringLength
Typ: UINT32-
Die Länge der Zeichenfolge in der 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). Wenn beispielsweise das Rendern auf einem 96 DPI-Gerät PixelsPerDip- 1 ist. Wenn das Rendering auf einem 120 DPI-Gerät PixelsPerDip 1,25 (120/96) beträgt.
[in, optional] transform
Typ: 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 angibt.
useGdiNatural
Typ: BOOL-
Weist das Textlayout an, dieselben Metriken wie GDI-Text auf biebener Ebene zu verwenden, wenn er auf FALSE-festgelegt ist. Wenn dieser Wert auf TRUEfestgelegt ist, weist das Textlayout an, dieselben Metriken wie von GDI gemessenen Text mithilfe einer schriftart zu verwenden, die mit CLEARTYPE_NATURAL_QUALITYerstellt wurde.
[out] textLayout
Typ: IDWriteTextLayout**
Wenn diese Methode zurückgegeben wird, enthält sie eine Adresse an den Zeiger des resultierenden Textlayoutobjekts.
Rückgabewert
Typ: HRESULT-
Wenn diese Methode erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.
Bemerkungen
Das resultierende Textlayout sollte nur für die beabsichtigte Auflösung verwendet werden, und für Fälle, in denen die Textskalierbarkeit gewünscht wird, CreateTextLayout verwendet werden sollte.
Anforderungen
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps | UWP-Apps] |
mindestens unterstützte Server- | Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps | UWP-Apps] |
Zielplattform- | Fenster |
Header- | dwrite.h |
Library | Dwrite.lib |
DLL- | Dwrite.dll |