WM_GETTEXT pesan
Menyalin teks yang sesuai dengan jendela ke dalam buffer yang disediakan oleh pemanggil.
#define WM_GETTEXT 0x000D
Parameter
-
wParam
-
Jumlah maksimum karakter yang akan disalin, termasuk karakter null yang mengakhiri.
Aplikasi ANSI mungkin memiliki string dalam buffer yang berkurang ukurannya (minimal setengah dari nilai wParam ) karena konversi dari ANSI ke Unicode.
-
lParam
-
Penunjuk ke buffer yang akan menerima teks.
Menampilkan nilai
Jenis: LRESULT
Nilai yang dikembalikan adalah jumlah karakter yang disalin, tidak termasuk karakter null yang mengakhiri.
Keterangan
Fungsi DefWindowProc menyalin teks yang terkait dengan jendela ke dalam buffer yang ditentukan dan mengembalikan jumlah karakter yang disalin. Catatan, untuk kontrol statis non-teks ini memberi Anda teks tempat kontrol awalnya dibuat, yaitu nomor ID. Namun, ini memberi Anda ID kontrol statis non-teks seperti yang awalnya dibuat. Artinya, jika Anda kemudian menggunakan STM_SETIMAGE untuk mengubahnya, ID asli akan tetap dikembalikan.
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 menyalin teks item dalam kotak daftar, aplikasi bisa menggunakan pesan LB_GETTEXT .
Ketika pesan WM_GETTEXT dikirim ke kontrol statis dengan gaya SS_ICON , handel ke ikon akan dikembalikan dalam empat byte pertama buffer yang ditujukkan oleh lParam. Ini benar hanya jika pesan WM_SETTEXT telah digunakan untuk mengatur ikon.
Edit Kaya: Jika teks yang akan disalin melebihi 64K, gunakan pesan EM_STREAMOUT atau EM_GETSELTEXT .
Mengirim pesan WM_GETTEXT ke kontrol statis non-teks, seperti bitmap statis atau kontrol ikon statis, tidak mengembalikan nilai string. Sebaliknya, ia mengembalikan nol. Selain itu, di versi awal Windows, aplikasi dapat mengirim pesan WM_GETTEXT ke kontrol statis non-teks untuk mengambil ID kontrol. Untuk mengambil ID kontrol, aplikasi dapat menggunakan GWL_ID passing GetWindowLong sebagai nilai indeks atau GetWindowLongPtr menggunakan GWLP_ID.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung |
Windows 2000 Server [hanya aplikasi desktop] |
| Header |
|
Lihat juga
-
Referensi
-
Konseptual
-
Sumber Daya Lainnya