ScrollWindowEx

Funcția ScrollWindowEx defilează conținutul din fereastra specificate client zona.

int () ScrollWindowEx HWND  hWnd, / / ocupa fereastra pentru a defilaint dx, / / valoarea orizontale de defilareint dy, / / valoarea verticale de defilareCONST RECT* prcScroll,  / / adresa de structura cu defilare dreptunghiCONST RECT* prcClip,  / / adresa de structura cu clip dreptunghiHRGNhrgnUpdate, / / mâner pentru a actualiza regiuneLPRECTprcUpdate, / / adresa de structura pentru actualizare dreptunghiUINTsteaguri / / scrolling steaguri);
 

Parametrii

hWnd
Ocupa în fereastra în care suprafața de client este să fie defilat.
dx
Specifică, în unită?i de dispozitiv, de defilare orizontală. Acest parametru trebuie să fie o valoare negativă pentru a defila la stânga.
dy
Specifică, în unită?i de dispozitiv, de derulare verticale. Acest parametru trebuie să fie o valoare negativă pentru a defila în sus.
prcScroll
Indicatorul pentru a RECT structura specifică porțiunea din zona de client pentru a fi defilat. Dacă acest parametru este NULL, întregii zone client este defilat.
prcClip
Indicatorul de structura RECT care con?in coordonatele dreptunghiul de tăiere. Numai dispozitiv biți în dreptunghiul de tăiere sunt afectate. Biți defilat din exteriorul dreptunghiul în interiorul sunt vopsite; biți defilat din interiorul dreptunghiului spre exterior nu sunt vopsite.
hrgnUpdate
Ocupa în regiune care este modificat să dețină regiunea invalidată de defilare. Acest parametru poate fi NULL.
prcUpdate
Indicatorul de structura RECT primirea limitele dreptunghiului invalidată de defilare. Acest parametru poate fi NULL.
steaguri
Specifică semnalizări care controlează defilare. Acest parametru poate fi una dintre următoarele valori:
Valoarea Sensul
SW_ERASE Șterge regiunea nou anulate prin trimiterea unui mesaj de WM_ERASEBKGND la fereastra când specificat cu pavilion SW_INVALIDATE.
SW_INVALIDATE Invalidează regiunea identificate de parametrul hrgnUpdate după defilarea.
SW_SCROLLCHILDREN Defilează toate ferestrele de copil care se intersectează dreptunghiul a subliniat de parametrul prcScroll . Ferestre copilului sunt defilat în prin numărul de pixeli specificate de parametrii de dx ?i dy . Sistemul trimite un mesaj WM_MOVE pentru toate ferestrele de copil care se intersectează dreptunghiul prcScroll , chiar dacă acestea nu se deplasează.
SW_SMOOTHSCROLL Windows NT 5.0 și mai târziu: Defilează utilizează defilarea lină. Utilizați partea HIWORD a parametrul flags pentru a indica cât de mult timp func?ionarea buna-defilare ar trebui să ia.

Valorile întroarse

Dacă funcția reușește, valoarea returnată este SIMPLEREGION (regiune dreptunghiulară invalidat), COMPLEXREGION (regiunea sunt anulate; se suprapun dreptunghiuri) sau NULLREGION (nu invalidează regiune).

Dacă funcția nu reușește, valoarea returnată este eroare. Pentru a obține extins informa?ii eroare, apel GetLastError.

Observații

Dacă nu sunt specificate steagurile SW_INVALIDATE ?i SW_ERASE, ScrollWindowEx nu invalidează zona care este defilat la. Dacă oricare dintre aceste semnalizări este setat, ScrollWindowEx invalidează acest domeniu. Zona nu este actualizat până la apelurile aplicarea UpdateWindow funcție, apeluri RedrawWindow funcție (precizând pavilion RDW_UPDATENOW sau RDW_ERASENOW), sau regăsește mesajul WM_PAINT din coada de aplicare.

Dacă fereastra are stilul WS_CLIPCHILDREN, zonele returnate specificate de hrgnUpdate și prcUpdate reprezintă suprafa?a totală a ferestrei scrolled care trebuie să fie actualizate, inclusiv orice zonă în windows copil care au nevoie de actualizarea.

Dacă este specificat pavilion SW_SCROLLCHILDREN, sistemul nu corect actualizați ecran dacă parte dintr-o fereastră de copil este defilat. Partea din fereastra scrolled copil care se află în afara dreptunghiului sursă nu este șters și nu este rescris corect în destinație nouă. Pentru a muta Ferestre copil care nu mint complet în interiorul dreptunghiului specificate de prcScroll, utilizați funcția DeferWindowPos . Cursorul este repoziționat dacă pavilion SW_SCROLLCHILDREN este stabilit și dreptunghiul semnul intersectează dreptunghiul defilare.

Toate coordonatele de intrare și de ieșire (pentru prcScroll, prcClip, prcUpdate?i hrgnUpdate) sunt determinate ca coordonatele client, indiferent dacă fereastra are stilul de clasa CS_OWNDC sau CS_CLASSDC. Se utilizează funcțiile LPtoDP și DPtoLP pentru a converti la și de la coordonatele logică, dacă este necesar.

Windows CE: Parametrul flags nu acceptă SW_SCROLLCHILDREN.

Numai unul dintre parametrii dx ?i dy poate fi diferită de zero.

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Necesită versiunea 1.0 sau mai târziu.
Antet:A declarat în winuser.h.
Import Biblioteca:Utilizarea user32.lib.

A se vedea, de asemenea

Defila baruri prezentare generală, funcții bara de defilare, DeferWindowPos, DPtoLP, LPtoDP, RECT, RedrawWindow, UpdateWindow

Index