WM_GETTEXTLENGTH pesan

Menentukan panjang, dalam karakter, teks yang terkait dengan jendela.

#define WM_GETTEXTLENGTH                0x000E

Parameter

wParam

Parameter ini tidak digunakan dan harus nol.

lParam

Parameter ini tidak digunakan dan harus nol.

Mengembalikan nilai

Jenis: LRESULT

Nilai yang dikembalikan adalah panjang teks dalam karakter, tidak termasuk karakter null yang mengakhiri.

Keterangan

Untuk kontrol edit, teks yang akan disalin adalah konten kontrol edit. Untuk kotak kombo, teks adalah konten bagian kontrol edit (atau teks statis) dari kotak kombo. Untuk tombol, teks adalah nama tombol. Untuk jendela lain, teks adalah judul jendela. Untuk menentukan panjang item dalam kotak daftar, aplikasi dapat menggunakan pesan LB_GETTEXTLEN .

Saat pesan WM_GETTEXTLENGTH dikirim, fungsi DefWindowProc mengembalikan panjang, dalam karakter, teks. Dalam kondisi tertentu, fungsi DefWindowProc mengembalikan nilai yang lebih besar dari panjang teks aktual. Ini terjadi dengan campuran ANSI dan Unicode tertentu, dan disebabkan oleh sistem yang memungkinkan adanya kemungkinan adanya karakter set karakter byte ganda (DBCS) dalam teks. Namun, nilai yang dikembalikan akan selalu setidaknya sebesar panjang teks yang sebenarnya; Dengan demikian Anda selalu dapat menggunakannya untuk memandu alokasi buffer. Perilaku ini dapat terjadi ketika aplikasi menggunakan fungsi ANSI dan dialog umum, yang menggunakan Unicode.

Untuk mendapatkan panjang teks yang tepat, gunakan WM_GETTEXT,LB_GETTEXT, atau pesan CB_GETLBTEXT , atau fungsi GetWindowText .

Mengirim pesan WM_GETTEXTLENGTH ke kontrol statis non-teks, seperti bitmap statis atau kontrol ikon statis, tidak mengembalikan nilai string. Sebaliknya, ia mengembalikan nol.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Winuser.h (termasuk Windows.h)

Lihat juga

Referensi

DefWindowProc

GetWindowText

GetWindowTextLength

WM_GETTEXT

Konseptual

Windows

Sumber Daya Lainnya

CB_GETLBTEXT

LB_GETTEXT

LB_GETTEXTLEN