Fungsi ScrollDC (winuser.h)
Fungsi ScrollDC menggulir persegi panjang bit secara horizontal dan vertikal.
Sintaks
BOOL ScrollDC(
[in] HDC hDC,
[in] int dx,
[in] int dy,
[in] const RECT *lprcScroll,
[in] const RECT *lprcClip,
[in] HRGN hrgnUpdate,
[out] LPRECT lprcUpdate
);
Parameter
[in] hDC
Jenis: HDC
Tangani ke konteks perangkat yang berisi bit yang akan digulir.
[in] dx
Jenis: int
Menentukan jumlah, dalam unit perangkat, dari pengguliran horizontal. Parameter ini harus berupa nilai negatif untuk menggulir ke kiri.
[in] dy
Jenis: int
Menentukan jumlah, dalam unit perangkat, dari pengguliran vertikal. Parameter ini harus berupa nilai negatif untuk menggulir ke atas.
[in] lprcScroll
Jenis: const RECT*
Penunjuk ke struktur RECT yang berisi koordinat bit yang akan digulir. Satu-satunya bit yang terpengaruh oleh operasi gulir adalah bit di persimpangan persegi panjang ini dan persegi panjang yang ditentukan oleh lprcClip. Jika lprcScroll adalah NULL, seluruh area klien digunakan.
[in] lprcClip
Jenis: const RECT*
Penunjuk ke struktur RECT yang berisi koordinat persegi panjang kliping. Satu-satunya bit yang akan dicat adalah bit yang tersisa di dalam persegi panjang ini setelah operasi gulir selesai. Jika lprcClipadalah NULL, seluruh area klien digunakan.
[in] hrgnUpdate
Jenis: HRGN
Tangani ke wilayah yang tidak terungkap oleh proses pengguliran. ScrollDC mendefinisikan wilayah ini; itu belum tentu persegi panjang.
[out] lprcUpdate
Jenis: LPRECT
Penunjuk ke struktur RECT yang menerima koordinat persegi panjang yang menghubungkan wilayah pembaruan pengguliran. Ini adalah area persegi panjang terbesar yang membutuhkan pengecatan ulang. Saat fungsi kembali, nilai dalam struktur berada dalam koordinat klien, terlepas dari mode pemetaan untuk konteks perangkat yang ditentukan. Ini memungkinkan aplikasi untuk menggunakan wilayah pembaruan dalam panggilan ke fungsi InvalidateRgn , jika diperlukan.
Nilai kembali
Jenis: BOOL
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Jika parameter lprcUpdate adalah NULL, sistem tidak menghitung persegi panjang pembaruan. Jika parameter hrgnUpdate dan lprcUpdateadalah NULL, sistem tidak menghitung wilayah pembaruan. Jika hrgnUpdate bukan NULL, sistem melanjutkan seolah-olah berisi handel yang valid ke wilayah yang diungkap oleh proses pengguliran (ditentukan oleh ScrollDC).
Saat Anda harus menggulir seluruh area klien jendela, gunakan fungsi ScrollWindowEx .
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | winuser.h (sertakan Windows.h) |
Pustaka | User32.lib |
DLL | User32.dll |
Set API | ext-ms-win-ntuser-misc-l1-5-0 (diperkenalkan dalam Windows 10, versi 10.0.10240) |
Lihat juga
Sumber Daya Lain
Referensi