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	Winuser.h (termasuk Windows.h)

Lihat juga

Referensi

DefWindowProc

GetWindowLong

GetWindowLongPtr

GetWindowText

GetWindowTextLength

WM_GETTEXTLENGTH

WM_SETTEXT

Konseptual

Windows

Sumber Daya Lainnya

EM_GETSELTEXT

EM_STREAMOUT

LB_GETTEXT