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