pesan EM_SETLIMITTEXT

Mengatur batas teks kontrol edit. Batas teks adalah jumlah maksimum teks, dalam TCHARs, yang dapat diketik pengguna ke dalam kontrol edit. Anda bisa mengirim pesan ini ke kontrol edit atau kontrol edit kaya.

Untuk kontrol edit dan Microsoft Rich Edit 1.0, byte digunakan. Untuk Microsoft Rich Edit 2.0 dan yang lebih baru, karakter digunakan.

Pesan EM_SETLIMITTEXT identik dengan pesan EM_LIMITTEXT .

Parameter

wParam

Jumlah maksimum TCHARyang dapat dimasukkan pengguna. Untuk teks ANSI, ini adalah jumlah byte; untuk teks Unicode, ini adalah jumlah karakter. Angka ini tidak termasuk karakter null yang mengakhiri.

Kontrol edit yang kaya: Jika parameter ini nol, panjang teks diatur ke 64.000 karakter.

Jika parameter ini nol, panjang teks diatur ke 0x7FFFFFFE karakter untuk kontrol edit baris tunggal atau 1 untuk kontrol pengeditan multibaris.

lParam

Parameter ini tidak digunakan.

Nilai kembali

Pesan ini tidak mengembalikan nilai.

Keterangan

Pesan EM_SETLIMITTEXT hanya membatasi teks yang dapat dimasukkan pengguna. Ini tidak mempengaruhi teks apa pun yang sudah ada di kontrol edit ketika pesan dikirim, juga tidak mempengaruhi panjang teks yang disalin ke kontrol edit oleh pesan WM_SETTEXT . Jika aplikasi menggunakan pesan WM_SETTEXT untuk menempatkan lebih banyak teks ke dalam kontrol edit daripada yang ditentukan dalam pesan EM_SETLIMITTEXT , pengguna dapat mengedit seluruh konten kontrol edit.

Sebelum EM_SETLIMITTEXT dipanggil, batas default untuk jumlah teks yang dapat dimasukkan pengguna dalam kontrol edit adalah 32.767 karakter.

Untuk kontrol edit baris tunggal, batas teks 0x7FFFFFFE byte atau nilai parameter wParam , mana pun yang lebih kecil. Untuk kontrol edit multibaris, nilai ini adalah 1 byte atau nilai parameter wParam , mana pun yang lebih kecil.

Edit Kaya: Didukung di Microsoft Rich Edit 1.0 dan yang lebih baru. Gunakan EM_EXLIMITTEXT pesan untuk nilai panjang teks yang lebih besar dari 64.000. Untuk informasi tentang kompatibilitas versi edit kaya dengan berbagai versi sistem, lihat Tentang Kontrol Edit Kaya.

Persyaratan

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

Lihat juga

EM_GETLIMITTEXT