METODE ID2D1RenderTarget::D rawTextLayout (d2d1.h)

Menggambar teks yang diformat yang dijelaskan oleh objek IDWriteTextLayout yang ditentukan.

Sintaks

void DrawTextLayout(
       D2D1_POINT_2F          origin,
  [in] IDWriteTextLayout      *textLayout,
  [in] ID2D1Brush             *defaultFillBrush,
       D2D1_DRAW_TEXT_OPTIONS options
);

Parameter

origin

Jenis: D2D1_POINT_2F

Titik, dijelaskan dalam piksel independen perangkat, di mana sudut kiri atas teks yang dijelaskan oleh textLayout digambar.

[in] textLayout

Jenis: IDWriteTextLayout*

Teks yang diformat untuk digambar. Efek gambar apa pun yang tidak mewarisi dari ID2D1Resource diabaikan. Jika ada efek gambar yang mewarisi dari ID2D1Resource yang bukan kuas, metode ini gagal dan target render dimasukkan ke dalam status kesalahan.

[in] defaultFillBrush

Jenis: ID2D1Brush*

Kuas yang digunakan untuk melukis teks apa pun dalam textLayout yang belum memiliki kuas yang terkait dengannya sebagai efek menggambar (ditentukan oleh metode IDWriteTextLayout::SetDrawingEffect ).

options

Jenis: D2D1_DRAW_TEXT_OPTIONS

Nilai yang menunjukkan apakah teks harus diposisikan ke batas piksel dan apakah teks harus dipotong ke persegi tata letak. Nilai defaultnya adalah D2D1_DRAW_TEXT_OPTIONS_NONE, yang menunjukkan bahwa teks harus diposisikan ke batas piksel dan tidak boleh diklip ke persegi tata letak.

Mengembalikan nilai

Tidak ada

Keterangan

Saat menggambar teks yang sama berulang kali, menggunakan metode DrawTextLayout lebih efisien daripada menggunakan metode DrawText karena teks tidak perlu diformat dan tata letak diproses dengan setiap panggilan.

Metode ini tidak mengembalikan kode kesalahan jika gagal. Untuk menentukan apakah operasi menggambar (seperti DrawTextLayout) gagal, periksa hasil yang dikembalikan oleh metode ID2D1RenderTarget::EndDraw atau ID2D1RenderTarget::Flush .

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	d2d1.h
Pustaka	D2d1.lib
DLL	D2d1.dll

Lihat juga

ID2D1RenderTarget

Pemformatan dan Tata Letak Teks