EM_SETRECT pesan

  • Artikel

Mengatur persegi panjang pemformatan kontrol edit multibaris. Persegi panjang pemformatan adalah persegi panjang pembatas tempat kontrol menggambar teks. Persegi panjang pembatas tidak bergantung pada ukuran jendela kontrol edit.

Pesan ini hanya diproses oleh kontrol pengeditan multibaris. Anda dapat mengirim pesan ini ke kontrol edit atau kontrol edit yang kaya.

Parameter

wParam

Edit Kaya 2.0 dan yang lebih baru: Menunjukkan apakah lParam menentukan koordinat absolut atau relatif. Nilai nol menunjukkan koordinat absolut. Nilai 1 menunjukkan offset relatif terhadap persegi panjang pemformatan saat ini. (Offset bisa positif atau negatif.)

Edit kontrol dan Rich Edit 1.0: Parameter ini tidak digunakan dan harus nol.

lParam

Penunjuk ke struktur RECT yang menentukan dimensi baru persegi panjang. Jika parameter ini NULL, persegi panjang pemformatan diatur ke nilai defaultnya.

Menampilkan nilai

Pesan ini tidak mengembalikan nilai.

Keterangan

Mengatur lParam ke NULL tidak berpengaruh jika perangkat sentuh diinstal, atau jika EM_SETRECT dikirim dari utas yang memasang hook (lihat SetWindowsHookEx). Dalam kasus ini, lParam harus berisi pointer yang valid ke struktur RECT .

Pesan EM_SETRECT menyebabkan teks kontrol edit digambar ulang. Untuk mengubah ukuran persegi panjang pemformatan tanpa menggambar ulang teks, gunakan pesan EM_SETRECTNP .

Saat kontrol edit pertama kali dibuat, persegi panjang pemformatan diatur ke ukuran default. Anda dapat menggunakan pesan EM_SETRECT untuk membuat pemformatan persegi panjang lebih besar atau lebih kecil dari jendela kontrol edit.

Jika kontrol edit tidak memiliki bilah gulir horizontal, dan persegi panjang pemformatan diatur agar lebih besar dari jendela kontrol edit, baris teks melebihi lebar jendela kontrol edit (tetapi lebih kecil dari lebar persegi panjang pemformatan) dipotong alih-alih dibungkus.

Jika kontrol edit berisi batas, persegi panjang pemformatan dikurangi dengan ukuran batas. Jika Anda menyesuaikan persegi panjang yang dikembalikan oleh pesan EM_GETRECT , Anda harus menghapus ukuran batas sebelum menggunakan persegi panjang dengan pesan EM_SETRECT .

Edit Kaya: Didukung di Microsoft Rich Edit 1.0 dan yang lebih baru. Persegi pemformatan tidak menyertakan bilah pilihan, yang merupakan area tidak ditandai di sebelah kiri setiap paragraf. Saat pengguna mengklik bilah pilihan, baris terkait dipilih. Untuk informasi tentang kompatibilitas versi edit yang 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

Referensi

EM_GETRECT

EM_SETRECTNP

Sumber Daya Lainnya

RECT