IDCompositionSurface::Metode Gulir (dcomp.h)

Menggulir area persegi panjang dari permukaan logika Microsoft DirectComposition.

Sintaks

HRESULT Scroll(
  [in]           const RECT *scrollRect,
  [in, optional] const RECT *clipRect,
  [in]           int        offsetX,
  [in]           int        offsetY
);

Parameter

[in] scrollRect

Area persegi panjang permukaan yang akan digulir, relatif terhadap sudut kiri atas permukaan. Jika parameter ini NULL, seluruh permukaan akan digulir.

[in, optional] clipRect

ClipRect mengklip tujuan (scrollRect setelah offset) dari gulir. Satu-satunya konten bitmap yang akan digulirkan adalah konten yang tetap berada di dalam persegi klip setelah gulir selesai.

[in] offsetX

Jumlah pengguliran horizontal, dalam piksel. Gunakan nilai positif untuk menggulir ke kanan, dan nilai negatif untuk menggulir ke kiri.

[in] offsetY

Jumlah pengguliran vertikal, dalam piksel. Gunakan nilai positif untuk menggulir ke bawah, dan nilai negatif untuk menggulir ke atas.

Menampilkan nilai

Jika fungsi berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan. Lihat Kode Kesalahan DirectComposition untuk daftar kode kesalahan.

Keterangan

Metode ini memungkinkan aplikasi untuk melakukan blt/menyalin sub-persegi panjang objek permukaan DirectComposition. Ini menghindari penyajian ulang konten yang sudah tersedia.

Persegi panjang scrollRect harus terkandung dalam batas permukaan. Jika persegi panjang scrollRect berada di luar batas permukaan, metode ini gagal.

Bit yang disalin oleh operasi gulir (sumber) ditentukan oleh persimpangan persegi panjang scrollRect dan clipRect .

Bit yang ditampilkan pada layar (tujuan) ditentukan oleh persimpangan persegi panjang sumber offset dan clipRect.

Operasi gulir hanya dapat dipanggil sebelum memanggil BeginDraw atau setelah memanggil EndDraw. Permukaan yang ditangguhkan atau dilanjutkan bukan kandidat untuk digulirkan karena masih diperbarui.

Aplikasi ini bertanggung jawab untuk memastikan bahwa area yang dapat digulirkan untuk IDCompositionVirtualSurface terbatas pada piksel yang valid. Perilaku untuk piksel yang tidak valid di scrollRect tidak terdefinisi.

Area sub-persegi panjang permukaan virtual yang dibuang oleh pemangkasan atau operasi pengubahan ukuran tidak dapat digulirkan meskipun pemangkasan atau pengubahan ukuran diterapkan dalam batch yang sama. Pangkas dan Mengubah Ukuran segera diterapkan.

Persyaratan

Klien minimum yang didukung	Windows 8 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	dcomp.h
Pustaka	Dcomp.lib
DLL	Dcomp.dll

Lihat juga

IDCompositionSurface