Bagikan melalui

IDWriteFactory::CreateGdiCompatibleTextLayout metode (dwrite.h)

  • Artikel

Mengambil string, format, dan batasan terkait, dan menghasilkan objek yang mewakili hasilnya, diformat untuk resolusi tampilan dan mode ukur tertentu.

Sintaks

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

Jenis: const WCHAR*

Array karakter yang berisi string untuk membuat objek IDWriteTextLayout baru. Array ini harus memiliki panjang stringLength dan dapat berisi karakter NULL yang disematkan.

stringLength

Jenis: UINT32

Panjang string, dalam jumlah karakter.

textFormat

Jenis: IDWriteTextFormat*

Objek pemformatan teks untuk diterapkan ke string.

layoutWidth

Jenis: FLOAT

Lebar kotak tata letak.

layoutHeight

Jenis: FLOAT

Tinggi kotak tata letak.

pixelsPerDip

Jenis: FLOAT

Jumlah piksel fisik per DIP (piksel independen perangkat). Misalnya, jika penyajian ke perangkat DPI 96 pixelsPerDip adalah 1. Jika penyajian ke perangkat 120 DPI pixelsPerDip adalah 1,25 (120/96).

[in, optional] transform

Jenis: const DWRITE_MATRIX*

Transformasi opsional diterapkan ke glyph dan posisinya. Transformasi ini diterapkan setelah penskalakan menentukan ukuran font dan piksel per DIP.

useGdiNatural

Jenis: BOOL

Menginstruksikan tata letak teks untuk menggunakan metrik yang sama dengan teks tingkat dua GDI saat diatur ke FALSE. Saat diatur ke TRUE, menginstruksikan tata letak teks untuk menggunakan metrik yang sama dengan teks yang diukur oleh GDI menggunakan font yang dibuat dengan CLEARTYPE_NATURAL_QUALITY.

[out] textLayout

Jenis: IDWriteTextLayout**

Ketika metode ini kembali, berisi alamat ke penunjuk objek tata letak teks yang dihasilkan.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Tata letak teks yang dihasilkan hanya boleh digunakan untuk resolusi yang dimaksudkan, dan untuk kasus di mana skalabilitas teks diinginkan CreateTextLayout harus digunakan sebagai gantinya.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header dwrite.h
Pustaka Dwrite.lib
DLL Dwrite.dll

Lihat juga

IDWriteFactory