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
0	Teks digambar dengan batas agar tampak lebih rendah dari bidang jendela.
SBT_NOBORDERS	Teks digambar tanpa batas.
SBT_POPOUT	Teks digambar dengan batas agar tampak lebih tinggi dari bidang jendela.
SBT_RTLREADING	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	Commctrl.h
Nama Unicode dan ANSI	SB_GETTEXTW (Unicode) dan SB_GETTEXTA (ANSI)

Lihat juga

SB_SETTEXT