Freigeben über


CDC::ScrollDC

Führt ein Rechteck von Bits horizontal und vertikal aus.

BOOL ScrollDC( 
   int dx, 
   int dy, 
   LPCRECT lpRectScroll, 
   LPCRECT lpRectClip, 
   CRgn* pRgnUpdate, 
   LPRECT lpRectUpdate  
);

Parameter

  • dx
    Gibt die Anzahl der horizontalen Bildlaufeinheiten an.

  • Dy
    Gibt die Anzahl der vertikalen Bildlaufeinheiten an.

  • lpRectScroll
    Zeigt auf RECT-Struktur oder zu CRect-Objekt, die die Koordinaten des Bildlaufrechtecks enthält.

  • lpRectClip
    Zeigt auf RECT-Struktur oder zu CRect-Objekt, die die Koordinaten des Ausschneiderechtecks enthält. Wenn dieses Rechteck kleiner als das ursprüngliche ist, die auf durch lpRectScroll gezeigt wird, tritt das Scrollen nur im kleineren Rechteck auf.

  • pRgnUpdate
    Identifiziert den Bereich, der von den Bildlaufprozess zumindest teilweise nicht überdeckt wird. Die ScrollDC-Funktion definiert diesen Bereich; es ist nicht notwendigerweise ein Rechteck.

  • lpRectUpdate
    Zeigt auf RECT-Struktur oder zu CRect-Objekt, die die Koordinaten des Rechtecks empfängt, das den Bildlaufupdatebereich begrenzt. Dies ist der größte rechteckige Bereich, der das neu zu erfordert. Die Werte in der Struktur oder im Objekt, wenn die Funktion in Clientkoordinaten sind, unabhängig vom Zuordnungsmodus für den angegebenen Gerätekontext.

Rückgabewert

Ungleich 0 (null), beim Bildlauf ausgeführt wird; 0 andernfalls.

Hinweise

Wenn lpRectUpdateNULL ist, berechnet das Windows nicht Updaterechteck. Wenn pRgnUpdate und lpRectUpdateNULL sind, berechnet Windows nicht das UpdatePanel. Wenn pRgnUpdate nicht NULL ist, nimmt Windows an, dass er einen gültigen Zeiger auf den Bereich enthält, der vom Bildlaufprozess zumindest teilweise nicht überdeckt wird (durch die ScrollDC-Memberfunktion). Das UpdatePanel, der in lpRectUpdate zurückgegeben wird, kann zu CWnd::InvalidateRgn nach Bedarf übergeben werden.

Eine Anwendung sollte die ScrollWindow-Memberfunktion der Klasse CWnd verwenden, wenn es erforderlich ist, den gesamten Clientbereich eines Fensters liegen. Andernfalls sollte sie ScrollDC verwenden.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CDC-Klasse

Hierarchiediagramm

CWnd::InvalidateRgn

CWnd::ScrollWindow

ScrollDC

CRgn-Klasse

RECT-Struktur

CRect Class