ScrollDC-Funktion (winuser.h)

Artikel
03/04/2024

Die ScrollDC-Funktion scrollt horizontal und vertikal ein Rechteck von Bits.

Syntax

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

Typ: HDC

Handle mit dem Gerätekontext, der die zu scrollenden Bits enthält.

[in] dx

Typ: int

Gibt die Menge des horizontalen Bildlaufs in Geräteeinheiten an. Dieser Parameter muss ein negativer Wert sein, um nach links zu scrollen.

[in] dy

Typ: int

Gibt die Menge des vertikalen Bildlaufs in Geräteeinheiten an. Dieser Parameter muss ein negativer Wert sein, um nach oben zu scrollen.

[in] lprcScroll

Typ: const RECT*

Zeiger auf eine RECT-Struktur , die die Koordinaten der zu scrollenden Bits enthält. Die einzigen Bits, die vom Bildlaufvorgang betroffen sind, sind Bits in der Schnittmenge dieses Rechtecks und des durch lprcClip angegebenen Rechtecks. Wenn lprcScrollNULL ist, wird der gesamte Clientbereich verwendet.

[in] lprcClip

Typ: const RECT*

Zeiger auf eine RECT-Struktur , die die Koordinaten des Abschneiderechtecks enthält. Die einzigen Bits, die gezeichnet werden, sind die Bits, die in diesem Rechteck verbleiben, nachdem der Bildlaufvorgang abgeschlossen wurde. Wenn lprcClipNULL ist, wird der gesamte Clientbereich verwendet.

[in] hrgnUpdate

Typ: HRGN

Behandeln Sie die Region, die durch den Bildlaufvorgang aufgedeckt wurde. ScrollDC definiert diese Region. es ist nicht unbedingt ein Rechteck.

[out] lprcUpdate

Typ: LPRECT

Zeiger auf eine RECT-Struktur , die die Koordinaten des Rechtecks empfängt, das den Bildlaufaktualisierungsbereich umgrenzt. Dies ist der größte rechteckige Bereich, der neu gestrichen werden muss. Wenn die Funktion zurückgibt, befinden sich die Werte in der Struktur in Clientkoordinaten, unabhängig vom Zuordnungsmodus für den angegebenen Gerätekontext. Dadurch können Anwendungen bei Bedarf den Updatebereich in einem Aufruf der InvalidateRgn-Funktion verwenden.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn der lprcUpdate-ParameterNULL ist, berechnet das System das Updaterechteck nicht. Wenn sowohl die Parameter hrgnUpdate als auch lprcUpdateNULL sind, berechnet das System den Updatebereich nicht. Wenn hrgnUpdate nicht NULL ist, geht das System so fort, als ob es ein gültiges Handle für die Region enthält, die durch den Scrollvorgang (definiert durch ScrollDC) aufgedeckt wird.

Wenn Sie den gesamten Clientbereich eines Fensters scrollen müssen, verwenden Sie die ScrollWindowEx-Funktion .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-misc-l1-5-0 (eingeführt in Windows 10, Version 10.0.10240)

Weitere Informationen

InvalidateRgn

Andere Ressourcen

RECT

Referenz

ScrollWindowEx

Freigeben über