Freigeben über


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

Siehe auch

IDWriteFactory-