Bagikan melalui


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.