ScrollWindowEx

Die ScrollWindowEx -Funktion führt einen Bildlauf durch den Inhalt des angegebenen Fensters Client-Bereich.

Int ScrollWindowEx) HWND  hWnd, / / handle zum Fenster zu blätternint dx, / / Höhe der Horizontal scrollenint dy, / / Betrag der vertikalen BildlaufCONST RECT* PrcScroll,  / / Adresse der Struktur mit Scroll-RechteckCONST RECT* PrcClip,  / / Adresse der Struktur mit CliprechteckHRGNhrgnUpdate, / / handle Region aktualisierenLPRECTprcUpdate, / / Adresse der Struktur für Update RechteckUINTFahnen / / Scrollen Flaggen);
 

Parameter

hWnd

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

dx

Gibt die Höhe in Geräteeinheiten, horizontale Bildläufe. Dieser Parameter muss ein negativer Wert nach links scrollen.

dy

Gibt die Höhe in Geräteeinheiten, vertikale Bildläufe. Dieser Parameter muss einen negativen Wert oben scrollen.

prcScroll

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

prcClip

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.

hrgnUpdate

Handle für die Region, die geändert wird, um die Region ungültig durch Scrollen zu halten. Dieser Parameter kann NULL sein.

prcUpdate

Zeiger auf die RECT -Struktur erhalten die Grenzen des Rechtecks durch Scrollen für ungültig erklärt. Dieser Parameter kann NULL sein.

flaggen

Gibt Flags an, die Steuern, scrollen. Dieser Parameter kann eine der folgenden Werte sein:

Wert	Bedeutung
SW_ERASE	Löscht die neu ungültig Region WM_ERASEBKGND Nachricht senden, um das Fenster mit dem SW_INVALIDATE-Flag angegeben.
SW_INVALIDATE	Nach dem Blättern durch den HrgnUpdate -Parameter identifizierten für ungültig erklärt.
SW_SCROLLCHILDREN	Führt einen Bildlauf durch alle untergeordneten Fenstern, die das Rechteck auf die Parameter der PrcScroll schneiden. Die untergeordneten Fenster sind durch die Anzahl der Pixel angegeben durch die Parameter Dx und dy gescrollt. Das System sendet eine Nachricht WM_MOVE an alle untergeordneten Fenstern, die das PrcScroll -Rechteck schneiden, auch wenn sie nicht verschoben werden.
SW_SMOOTHSCROLL	Windows NT 5.0 und höher: Führt einen Bildlauf durch optimierten Bildlauf verwenden. Verwenden Sie den HIWORD Teil des Flags -Parameters, um anzugeben, wie viel Zeit der optimierten Bildlauf Vorgang dauern sollte.

Rückgabewerte

Wenn die Funktion erfolgreich ist, ist der Rückgabewert SIMPLEREGION (rechteckige ungültig Region), COMPLEXREGION (nicht rechteckige Region ungültig; überlappende Rechtecke) oder NULLREGION (keine überschriebenen Region).

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

Bemerkungen

Wenn die Flags SW_INVALIDATE und SW_ERASE nicht angegeben werden, ungültig nicht ScrollWindowEx Bereich, der aus ein Bildlauf durchgeführt wird. Wenn eines dieser Flags festgelegt ist, ungültig ScrollWindowEx diesem Gebiet. Bereich wird nicht aktualisiert, bis die Anwendung Aufrufe der UpdateWindow Funktion, fordert die RedrawWindow -Funktion (zur Angabe der RDW_UPDATENOW oder RDW_ERASENOW-Flag) oder ruft die WM_PAINT-Nachricht von der Anwendungswarteschlange.

Wenn das Fenster das WS_CLIPCHILDREN-Format hat, repräsentieren die zurückgegebene Bereiche durch HrgnUpdate und PrcUpdate angegeben die gesamte Fläche des Fensters ein Bildlauf ausgeführt, die aktualisiert werden muss, einschließlich der Bereiche in untergeordneten Fenstern, die aktualisiert werden müssen.

Wenn das SW_SCROLLCHILDREN-Flag angegeben ist, wird das System nicht richtig Bildschirm aktualisieren, wenn Teil eines untergeordneten Fensters ein Bildlauf durchgeführt wird. Der Teil des Fensters gescrollt Kind, das außerhalb des Quellrechtecks liegt wird nicht gelöscht und ist nicht ordnungsgemäß in das neue Ziel neu gezeichnet. Um untergeordnete Fenster verschieben, die nicht vollständig in das durch PrcScrollangegebene Rechteck liegen, verwenden Sie die DeferWindowPos -Funktion. Der Cursor positioniert ist, wenn das SW_SCROLLCHILDREN-Flag festgelegt ist, und das Einfügemarke Rechteck das Scroll-Rechteck schneidet.

Alle Eingabe- und Koordinaten (für PrcScroll, PrcClip, PrcUpdateund HrgnUpdate) werden als Clientkoordinaten, unabhängig davon, ob das Fenster den Klassenstil CS_OWNDC oder CS_CLASSDC hat bestimmt. Verwenden Sie die LPtoDP und DPtoLP Funktionen zum Konvertieren in und aus logischen Koordinaten, falls erforderlich.

Windows CE: SW_SCROLLCHILDREN von der Flags -Parameter nicht unterstützt.

Nur einer der Parameter Dx und dy kann ungleich NULL sein.

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Version 1.0 oder höher benötigt.
Header:In winuser.h deklarierten.
Importieren Bibliothek:Verwenden Sie user32.lib.

Siehe auch

Bars Übersicht Scroll, Scroll Bar Funktionen, DeferWindowPos, DPtoLP, LPtoDP, RECT, RedrawWindow, UpdateWindow

Index