Bilah Gulir
Bagian ini berisi informasi tentang elemen pemrograman yang digunakan dengan bilah gulir. Jendela dapat menampilkan objek data, seperti dokumen atau bitmap, yang lebih besar dari area klien jendela. Ketika disediakan dengan bilah gulir , pengguna dapat menggulir objek data di area klien untuk melihat bagian objek yang membentang di luar batas jendela.
Ikhtisar
Topik | Isi |
---|---|
Tentang Bilah Gulir | Bilah gulir terdiri dari poros berteduh dengan tombol panah di setiap ujung dan kotak gulir (terkadang disebut ibu jari) di antara tombol panah. |
Menggunakan Bilah Gulir | Saat membuat jendela tumpang tindih, pop-up, atau turunan, Anda dapat menambahkan bilah gulir standar dengan menggunakan fungsiCreateWindowEx dan menentukan WS_HSCROLL, WS_VSCROLL, atau kedua gaya. |
Fungsi
Topik | Isi |
---|---|
EnableScrollBar | FungsiEnableScrollBar memungkinkan atau menonaktifkan satu atau kedua panah bilah gulir. |
GetScrollBarInfo | Fungsi GetScrollBarInfo mengambil informasi tentang bilah gulir yang ditentukan. |
GetScrollInfo | Fungsi GetScrollInfo mengambil parameter bilah gulir, termasuk posisi gulir minimum dan maksimum, ukuran halaman, dan posisi kotak gulir (jempol). |
GetScrollPos | FungsiGetScrollPos mengambil posisi kotak gulir (jempol) saat ini di bilah gulir yang ditentukan. Posisi saat ini adalah nilai relatif yang bergantung pada rentang gulir saat ini. Misalnya, jika rentang gulir adalah 0 hingga 100 dan kotak gulir berada di tengah bilah, posisi saat ini adalah 50.
Catatan: FungsiGetScrollPos disediakan untuk kompatibilitas mundur. Aplikasi baru harus menggunakan fungsiGetScrollInfo. |
GetScrollRange | FungsiGetScrollRange mengambil posisi kotak gulir minimum dan maksimum (thumb) saat ini untuk bilah gulir yang ditentukan.
Catatan: FungsiGetScrollRange disediakan hanya untuk kompatibilitas. Aplikasi baru harus menggunakan fungsiGetScrollInfo. |
ScrollDC | Fungsi ScrollDC menggulir persegi bit secara horizontal dan vertikal. |
ScrollWindow | Fungsi ScrollWindow menggulir konten area klien jendela yang ditentukan.
Catatan: FungsiScrollWindow disediakan untuk kompatibilitas mundur. Aplikasi baru harus menggunakan fungsiScrollWindowEx. |
ScrollWindowEx | FungsiScrollWindowEx menggulir konten area klien jendela yang ditentukan. |
SetScrollInfo | Fungsi SetScrollInfo mengatur parameter bilah gulir, termasuk posisi gulir minimum dan maksimum, ukuran halaman, dan posisi kotak gulir (jempol). Fungsi ini juga menggambar ulang bilah gulir, jika diminta. |
SetScrollPos | Fungsi SetScrollPos mengatur posisi kotak gulir (jempol) di bilah gulir yang ditentukan dan, jika diminta, menggambar ulang bilah gulir untuk mencerminkan posisi baru kotak gulir.
Catatan: FungsiSetScrollPosdisediakan untuk kompatibilitas mundur. Aplikasi baru harus menggunakan fungsiSetScrollInfo. |
SetScrollRange | Fungsi SetScrollRange mengatur posisi kotak gulir minimum dan maksimum untuk bilah gulir yang ditentukan.
Catatan: FungsiSetScrollRangedisediakan untuk kompatibilitas mundur. Aplikasi baru harus menggunakan fungsiSetScrollInfo. |
ShowScrollBar | Fungsi ShowScrollBar memperlihatkan atau menyembunyikan bilah gulir yang ditentukan. |
Pesan
Topik | Isi |
---|---|
SBM_ENABLE_ARROWS | Aplikasi mengirim pesan SBM_ENABLE_ARROWS untuk mengaktifkan atau menonaktifkan satu atau kedua panah kontrol bilah gulir. |
SBM_GETPOS | Pesan SBM_GETPOS dikirim untuk mengambil posisi kotak gulir saat ini dari kontrol bilah gulir. Posisi saat ini adalah nilai relatif yang bergantung pada rentang gulir saat ini. Misalnya, jika rentang gulir adalah 0 hingga 100 dan kotak gulir berada di tengah bilah, posisi saat ini adalah 50. Aplikasi tidak boleh mengirim pesan ini secara langsung. Sebagai gantinya, mereka harus menggunakan fungsi GetScrollPos. Jendela menerima pesan ini melalui fungsiWindowProc. Aplikasi yang menerapkan kontrol bilah gulir kustom harus merespons pesan ini agar fungsi GetScrollPos berfungsi dengan baik. |
SBM_GETRANGE | Pesan SBM_GETRANGE dikirim untuk mengambil nilai posisi minimum dan maksimum untuk kontrol bilah gulir. Aplikasi tidak boleh mengirim pesan ini secara langsung. Sebagai gantinya, mereka harus menggunakan fungsiGetScrollRange. Jendela menerima pesan ini melalui fungsiWindowProc. Aplikasi yang menerapkan kontrol bilah gulir kustom harus merespons pesan ini agar fungsi GetScrollRange berfungsi dengan baik. |
SBM_GETSCROLLBARINFO | Dikirim oleh aplikasi untuk mengambil informasi tentang bilah gulir yang ditentukan. |
SBM_GETSCROLLINFO | Pesan SBM_GETSCROLLINFO dikirim untuk mengambil parameter bilah gulir. Aplikasi tidak boleh mengirim pesan ini secara langsung. Sebagai gantinya, mereka harus menggunakan fungsiGetScrollInfo. Jendela menerima pesan ini melalui fungsiWindowProc. Aplikasi yang menerapkan kontrol bilah gulir kustom harus merespons pesan ini agar fungsi GetScrollInfo berfungsi dengan baik. |
SBM_SETPOS | Pesan SBM_SETPOS dikirim untuk mengatur posisi kotak gulir (jempol) dan, jika diminta, gulir ulang bilah gulir untuk mencerminkan posisi baru kotak gulir. Aplikasi tidak boleh mengirim pesan ini secara langsung. Sebagai gantinya, mereka harus menggunakan fungsi SetScrollPos. Jendela menerima pesan ini melalui fungsiWindowProc. Aplikasi yang menerapkan kontrol bilah gulir kustom harus merespons pesan ini agar fungsi SetScrollPos berfungsi dengan baik. |
SBM_SETRANGE | Pesan SBM_SETRANGE dikirim untuk mengatur nilai posisi minimum dan maksimum untuk kontrol bilah gulir. Aplikasi tidak boleh mengirim pesan ini secara langsung. Sebagai gantinya, mereka harus menggunakan fungsiSetScrollRange. Jendela menerima pesan ini melalui fungsiWindowProc. Aplikasi yang menerapkan kontrol bilah gulir kustom harus merespons pesan ini agar fungsi setScrollRange berfungsi dengan baik. |
SBM_SETRANGEREDRAW | Aplikasi mengirim pesan SBM_SETRANGEREDRAW ke kontrol bilah gulir untuk mengatur nilai posisi minimum dan maksimum dan untuk menggambar ulang kontrol. |
SBM_SETSCROLLINFO | Pesan SBM_SETSCROLLINFO dikirim untuk mengatur parameter bilah gulir. Aplikasi tidak boleh mengirim pesan ini secara langsung. Sebagai gantinya, mereka harus menggunakan fungsiSetScrollInfo. Jendela menerima pesan ini melalui fungsiWindowProc. Aplikasi yang menerapkan kontrol bilah gulir kustom harus merespons pesan ini agar fungsi SetScrollInfo berfungsi dengan baik. |
Pemberitahuan
Topik | Isi |
---|---|
WM_CTLCOLORSCROLLBAR | Pesan WM_CTLCOLORSCROLLBAR dikirim ke jendela induk kontrol bilah gulir saat kontrol akan digambar. Dengan menanggapi pesan ini, jendela induk dapat menggunakan handel konteks tampilan untuk mengatur warna latar belakang kontrol bilah gulir. Jendela menerima pesan ini melalui fungsiWindowProc. |
WM_HSCROLL | Pesan WM_HSCROLL dikirim ke jendela saat peristiwa gulir terjadi di bilah gulir horizontal standar jendela. Pesan ini juga dikirim ke pemilik kontrol bilah gulir horizontal saat peristiwa gulir terjadi di kontrol. Jendela menerima pesan ini melalui fungsiWindowProc. |
WM_VSCROLL | Pesan WM_VSCROLL dikirim ke jendela saat peristiwa gulir terjadi di bilah gulir vertikal standar jendela. Pesan ini juga dikirim ke pemilik kontrol bilah gulir vertikal saat peristiwa gulir terjadi di kontrol. Jendela menerima pesan ini melalui fungsiWindowProc. |
Struktur
Topik | Isi |
---|---|
SCROLLBARINFO | StrukturSCROLLBARINFO berisi informasi bilah gulir. |
SCROLLINFO | Struktur SCROLLINFO berisi parameter bilah gulir yang akan diatur oleh fungsiSetScrollInfo (atau pesan SBM_SETSCROLLINFO), atau diambil oleh fungsiGetScrollInfo (atau pesan SBM_GETSCROLLINFO). |
Konstanta
Topik | Isi |
---|---|
Gaya Kontrol Bilah Gulir | Untuk membuat kontrol bilah gulir menggunakan fungsi CreateWindow atau CreateWindowEx tentukan kelas SCROLLBAR, konstanta gaya jendela yang sesuai, dan kombinasi gaya kontrol bilah gulir berikut. Beberapa gaya membuat kontrol bilah gulir yang menggunakan lebar atau tinggi default. Namun, Anda harus selalu menentukan koordinat x dan y dan dimensi lain dari bilah gulir saat Anda memanggil CreateWindow atau CreateWindowEx. |