ID2D1RenderTarget::D rawText(constWCHAR*,UINT32,IDWriteTextFormat*,constD2D1_RECT_F&,ID2D1Brush*,D2D1_DRAW_TEXT_OPTIONS,DWRITE_MEASURING_MODE) metode (d2d1.h)

Menggambar teks yang ditentukan menggunakan informasi format yang disediakan oleh objek IDWriteTextFormat .

Sintaks

void DrawText(
  [in]  const WCHAR            *string,
        UINT32                 stringLength,
  [in]  IDWriteTextFormat      *textFormat,
  [ref] const D2D1_RECT_F &    layoutRect,
  [in]  ID2D1Brush             *defaultFillBrush,
        D2D1_DRAW_TEXT_OPTIONS options,
        DWRITE_MEASURING_MODE  measuringMode
);

Parameter

[in] string

Jenis: WCHAR*

Penunjuk ke array karakter Unicode untuk digambar.

stringLength

Jenis: UINT

Jumlah karakter dalam string.

[in] textFormat

Jenis: IDWriteTextFormat*

Objek yang menjelaskan detail pemformatan teks yang akan digambar, seperti font, ukuran font, dan arah alur.

[ref] layoutRect

Jenis: const D2D1_RECT_F

Ukuran dan posisi area tempat teks digambar.

[in] defaultFillBrush

Jenis: ID2D1Brush*

Kuas yang digunakan untuk melukis teks.

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.

measuringMode

Jenis: DWRITE_MEASURING_MODE

Nilai yang menunjukkan bagaimana metrik glyph digunakan untuk mengukur teks saat diformat. Nilai defaultnya adalah DWRITE_MEASURING_MODE_NATURAL.

Nilai kembali

Tidak ada

Keterangan

Untuk membuat objek IDWriteTextFormat , buat IDWriteFactory dan panggil metode CreateTextFormat-nya .

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

Contoh

Misalnya, lihat Cara: Menggambar Teks.

Persyaratan

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

DWRITE_MEASURING_MODE

DrawTextLayout

Cara: Gambar Teks

ID2D1RenderTarget

Pemformatan dan Tata Letak Teks