ScrollWindow

Die ScrollWindow -Funktion führt einen Bildlauf durch den Inhalt des angegebenen Fensters Clientbereich. Die ScrollWindow -Funktion ist für Abwärtskompatibilität vorhanden. Neue Anwendungen sollten die ScrollWindowEx -Funktion verwenden.

BOOL ScrollWindow) HWND  hWnd, / / handle zum Fenster zu blätternintXAmount, / / Höhe der Horizontal scrollenintYAmount, / / Betrag der vertikalen Bildlauf CONST RECT* LpRect,  / / Adresse der Struktur mit Scroll-RechteckCONST RECT* LpClipRect / / Adresse der Struktur mit Cliprechteck);
 

Parameter

hWnd

Handle für das Fenster, wo der Clientbereich ein Bildlauf durchgeführt werden soll.

XAmount

Gibt die Höhe in Geräteeinheiten, horizontale Bildläufe. Wenn das Fenster gescrollt wird das Format CS_OWNDC oder CS_CLASSDC hat, verwendet diesen Parameter logische Einheiten anstatt Geräteeinheiten. Dieser Parameter muss einen negativen Wert, um den Inhalt des Fensters nach links scrollen.

YAmount

Gibt die Höhe in Geräteeinheiten, vertikale Bildläufe. Wenn das Fenster gescrollt wird das Format CS_OWNDC oder CS_CLASSDC hat, verwendet diesen Parameter logische Einheiten anstatt Geräteeinheiten. Dieser Parameter muss einen negativen Wert, um den Inhalt des Fensters oben scrollen.

lpRect

Zeiger auf die RECT -Struktur, die den Teil des Clientbereichs gescrollt werden. Wenn dieser Parameter NULL ist, wird der gesamte Clientbereich gerollt.

lpClipRect

Zeiger auf die RECT -Struktur, enthält die Koordinaten der das Clipping-Rechteck. Nur Gerät Bits in das Clipping-Rechteck sind betroffen. Bit nach innen von der Außenseite des Rechtecks gescrollt werden gemalt; Bit von der Innenseite des Rechtecks an der Außenseite ein Bildlauf durchgeführt werden nicht gezeichnet.

Rückgabewerte

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (null). Rufen Sie Fehlerinformationen verlängert bekommen, GetLastError.

Bemerkungen

Wenn die Einfügemarke im Fenster wird ein Bildlauf durchgeführt wird, ScrollWindow blendet automatisch die Einfügemarke zu verhindern, dass es gelöscht wird und die Einfügemarke dann wiederhergestellt, nachdem das Scrollen. Die Position der Einfügemarke wird entsprechend angepasst.

Bereich von ScrollWindow aufgedeckt wird nicht aktualisiert, aber es wird in das Fenster Update Region kombiniert. Die Anwendung empfängt schließlich eine WM_PAINT-Nachricht benachrichtigt sie, dass die Region neu gezeichnet werden muss. Rufen Sie die UpdateWindow -Funktion, um das Freigelände zur gleichen Zeit neu zu zeichnen, die das Scrollen in Aktion ist, sofort nach dem Aufruf von ScrollWindow.

Wenn der LpRect -Parameter NULL ist, werden die Positionen der alle untergeordneten Fenster im Fenster durch den durch die Parameter XAmount und YAmount angegebenen Betrag ausgeglichen; Ungültige (unlackiert) Bereiche im Fenster werden auch verrechnet. ScrollWindow ist schneller, wenn LpRect NULL ist.

Wenn LpRect nicht NULL ist, werden die Positionen der untergeordneten Fenster nicht geändert und ungültige Bereiche im Fenster werden nicht ausgeglichen. Um zu verhindern Aktualisierung Probleme wenn LpRect nicht NULL ist, rufen Sie UpdateWindow , Fenster neu zu zeichnen, vor dem Aufruf von ScrollWindow.

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Nicht unterstützt.
Header:In winuser.h deklarierten.
Importieren Bibliothek:Verwenden Sie user32.lib.

Siehe auch

Bars Übersicht Scroll, Scroll Bar Funktionen, RECT, ScrollDC, ScrollWindowEx, UpdateWindow

Index