Bilah Gulir

Artikel
06/13/2023

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. Saat disediakan dengan bilah gulir, pengguna dapat menggulir objek data di area klien untuk melihat bagian objek yang membentang di luar batas jendela.

Gambaran Umum

Topik	Konten
Tentang Bilah Gulir	Bilah gulir terdiri dari poros berteduh dengan tombol panah di setiap ujung dan kotak gulir (kadang-kadang 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 fungsi CreateWindowEx dan menentukan WS_HSCROLL, WS_VSCROLL, atau kedua gaya.

Fungsi

Topik	Konten
EnableScrollBar	Fungsi EnableScrollBar 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	Fungsi GetScrollPos 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: Fungsi GetScrollPos disediakan untuk kompatibilitas mundur. Aplikasi baru harus menggunakan fungsi GetScrollInfo.
GetScrollRange	Fungsi GetScrollRange mengambil posisi kotak gulir minimum dan maksimum (jempol) saat ini untuk bilah gulir yang ditentukan. Catatan: Fungsi GetScrollRange disediakan hanya untuk kompatibilitas. Aplikasi baru harus menggunakan fungsi GetScrollInfo.
ScrollDC	Fungsi ScrollDC menggulir persegi bit secara horizontal dan vertikal.
ScrollWindow	Fungsi ScrollWindow menggulir konten area klien jendela yang ditentukan. Catatan: Fungsi ScrollWindow disediakan untuk kompatibilitas mundur. Aplikasi baru harus menggunakan fungsi ScrollWindowEx.
ScrollWindowEx	Fungsi ScrollWindowEx 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: Fungsi SetScrollPos disediakan untuk kompatibilitas mundur. Aplikasi baru harus menggunakan fungsi SetScrollInfo.
SetScrollRange	Fungsi SetScrollRange mengatur posisi kotak gulir minimum dan maksimum untuk bilah gulir yang ditentukan. Catatan: Fungsi SetScrollRange disediakan untuk kompatibilitas mundur. Aplikasi baru harus menggunakan fungsi SetScrollInfo.
TampilkanScrollBar	Fungsi ShowScrollBar memperlihatkan atau menyembunyikan bilah gulir yang ditentukan.

Pesan

Topik	Konten
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. Sebaliknya, mereka harus menggunakan fungsi GetScrollPos. Jendela menerima pesan ini melalui fungsi WindowProc-nya. 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 fungsi GetScrollRange . Jendela menerima pesan ini melalui fungsi WindowProc-nya. 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. Sebaliknya, mereka harus menggunakan fungsi GetScrollInfo. Jendela menerima pesan ini melalui fungsi WindowProc-nya. 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 fungsi WindowProc-nya. 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 fungsi SetScrollRange . Jendela menerima pesan ini melalui fungsi WindowProc-nya. 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 fungsi SetScrollInfo . Jendela menerima pesan ini melalui fungsi WindowProc-nya. Aplikasi yang menerapkan kontrol bilah gulir kustom harus merespons pesan ini agar fungsi SetScrollInfo berfungsi dengan baik.

Notifications

Topik	Konten
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 fungsi WindowProc-nya.
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 fungsi WindowProc-nya.
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 fungsi WindowProc-nya.

Struktur

Topik	Konten
SCROLLBARINFO	Struktur SCROLLBARINFO berisi informasi bilah gulir.
SCROLLINFO	Struktur SCROLLINFO berisi parameter bilah gulir yang akan diatur oleh fungsi SetScrollInfo (atau pesan SBM_SETSCROLLINFO), atau diambil oleh fungsi GetScrollInfo (atau pesan SBM_GETSCROLLINFO).

Konstanta

Topik	Konten
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

Konten

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