Fungsi DrawTextWrap

[DrawTextWrap tersedia melalui Windows XP dengan Paket Layanan 2 (SP2). Ini mungkin diubah atau tidak tersedia dalam versi berikutnya. Sebaiknya gunakan DrawText secara langsung sebagai gantinya.]

Menggambar teks yang diformat dalam persegi panjang yang ditentukan. Ini memformat teks sesuai dengan metode yang ditentukan (memperluas tab, membenarkan karakter, garis pemisah, dan sebagainya). Fungsi ini membungkus panggilan ke DrawText.

Sintaks

int WINAPI DrawTextWrap(
  _In_    HDC              hdc,
  _Inout_ LPCTSTR          lpString,
  _In_    int              nCount,
  _Inout_ LPRECT           lpRect,
  _In_    UINT             uFormat,
  _In_    LPDRAWTEXTPARAMS lpDTParams
);

Parameter

hdc [in]

Jenis: HDC

Handel ke konteks perangkat.

lpString [masuk, keluar]

Jenis: LPCTSTR

Penunjuk ke buffer yang berisi teks untuk digambar. Jika parameter nCount adalah -1, string harus dihentikan null.

Jika uFormat menyertakan DT_MODIFYSTRING, fungsi mungkin menambahkan hingga empat karakter tambahan ke string ini. Buffer yang berisi string harus cukup besar untuk mengakomodasi karakter tambahan ini.

nCount [in]

Jenis: int

Panjang string yang ditujukkan oleh lpString. Jika nCount adalah -1, maka parameter lpString diasumsikan sebagai penunjuk ke string yang dihentikan null dan DrawText menghitung jumlah karakter secara otomatis.

lpRect [masuk, keluar]

Jenis: LPRECT

Penunjuk ke struktur RECT yang berisi persegi panjang, dalam koordinat logis, di mana teks akan diformat.

uFormat [in]

Jenis: UINT

Opsi pemformatan. Lihat dokumentasi untuk DrawText untuk daftar lengkap opsi.

lpDTParams [in]

Jenis: LPDRAWTEXTPARAMS

Penunjuk ke struktur DRAWTEXTPARAMS yang menentukan opsi pemformatan tambahan. Parameter ini bisa NULL.

Nilai kembali

Jenis: int

Jika fungsi berhasil, nilai yang dikembalikan adalah tinggi teks dalam unit logis. Jika DT_VCENTER atau DT_BOTTOM ditentukan, nilai yang dikembalikan adalah offset dari anggota terataslprc ke bagian bawah teks yang digambar Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

DrawTextWrap tidak diekspor berdasarkan nama atau dinyatakan dalam header publik. Untuk menggunakannya, Anda harus menggunakan GetProcAddress dan meminta ordinal 415 dari ComCtl32.dll untuk mendapatkan penunjuk fungsi.

Untuk keterangan tambahan, silakan lihat DrawText.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
DLL	Comctl32.dll (versi 6.0 atau yang lebih baru)