Fungsi DrawTextExPrivWrap

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

Menggambar teks yang diformat dalam persegi panjang yang ditentukan. Fungsi ini membungkus panggilan ke DrawTextEx.

Sintaks

int WINAPI DrawTextExPrivWrap(
  _In_    HDC              hdc,
  _Inout_ LPTSTR           lpchText,
  _In_    int              cchText,
  _Inout_ LPRECT           lprc,
  _In_    UINT             dwDTFormat,
  _In_    LPDRAWTEXTPARAMS lpDTParams
);

Parameter

hdc [in]

Jenis: HDC

Handel ke konteks perangkat untuk menggambar.

lpchText [masuk, keluar]

Jenis: LPTSTR

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

Jika dwDTFormat 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.

cchText [in]

Jenis: int

Panjang string yang ditujukkan oleh lpchText. Jika cchText adalah -1, maka parameter lpchText diasumsikan sebagai penunjuk ke string null-terminated dan DrawTextEx menghitung jumlah karakter secara otomatis.

lprc [masuk, keluar]

Jenis: LPRECT

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

dwDTFormat [in]

Jenis: UINT

Opsi pemformatan. Lihat dokumentasi untuk DrawTextEx 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 ataslprc ke bagian bawah teks yang digambar.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

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

Untuk keterangan tambahan, silakan lihat DrawTextEx.

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)