Bilah Gulir

Artikel
03/12/2025

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.

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.

Bagikan melalui