SB_GETTEXT pesan
Mengambil teks dari bagian yang ditentukan dari jendela status.
Parameter
-
wParam
-
Indeks berbasis nol dari bagian untuk mengambil teks.
-
lParam
-
Penunjuk ke buffer yang menerima teks sebagai string yang dihentikan null. Gunakan pesan SB_GETTEXTLENGTH untuk menentukan ukuran buffer yang diperlukan.
Menampilkan nilai
Mengembalikan nilai 32-bit yang terdiri dari dua nilai 16-bit. Kata rendah menentukan panjang, dalam karakter, teks. Kata tinggi menentukan jenis operasi yang digunakan untuk menggambar teks. Jenisnya bisa menjadi salah satu nilai berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Teks digambar dengan batas agar tampak lebih rendah dari bidang jendela. |
|
Teks digambar tanpa batas. |
|
Teks digambar dengan batas agar tampak lebih tinggi dari bidang jendela. |
|
Teks ditampilkan dalam arah teks yang berlawanan di jendela induk. |
Keterangan
Peringatan Keamanan: Menggunakan pesan ini dengan tidak benar dapat membahayakan keamanan program Anda. Pesan ini tidak menyediakan cara bagi Anda untuk mengetahui ukuran buffer. Jika Anda menggunakan pesan ini, pertama-tama panggil SB_GETTEXTLENGTH untuk mendapatkan jumlah karakter yang diperlukan lalu panggil pesan untuk mengambil string. Jika Anda menunggu sebelum memanggil SB_GETTEXT teks dapat berubah, sehingga membatalkan nilai pengembalian SB_GETTEXTLENGTH. Anda harus meninjau Pertimbangan Keamanan: Kontrol Microsoft Windows sebelum melanjutkan.
Pesan ini mengembalikan maksimal 65.535 karakter. Jika string teks lebih panjang dari itu, string teks akan terpotong.
Jika teks memiliki jenis gambar SBT_OWNERDRAW, pesan ini mengembalikan nilai 32-bit yang terkait dengan teks, bukan panjang dan jenis operasi.
Jendela normal menampilkan teks kiri-ke-kanan (LTR). Windows dapat dicerminkan untuk menampilkan bahasa seperti Ibrani atau Arab yang membaca kanan-ke-kiri (RTL). Jika SBT_RTLREADING diatur, string lParam membaca ke arah yang berlawanan dari teks di jendela induk.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung |
Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung |
Windows Server 2003 [hanya aplikasi desktop] |
Header |
|
Nama Unicode dan ANSI |
SB_GETTEXTW (Unicode) dan SB_GETTEXTA (ANSI) |