Fungsi ScrollDC (winuser.h)

Artikel
03/04/2024

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)