ScrollWindowEx

Funksjonen ScrollWindowEx ruller innholdet i det angitte vinduet klientområdet.

int () ScrollWindowEx HWND  hWnd, / / håndtere til vinduet for å blaInt dx, / / beløp for vannrett rullingInt dy, / / beløp for loddrett rullingCONST RECT* prcScroll,  / / adresse av strukturen med Bla rektangelCONST RECT* prcClip,  / / adresse av strukturen med klipp rektangelHRGNhrgnUpdate, / / håndtere for å oppdatere regionenLPRECTprcUpdate, / / adresse av strukturen for oppdateringen rektangelUINTflagg / / rulling flagg);
 

Parametere

hWnd
Håndtere til vinduet der klientområdet er å rulles.
dx
Angir hvor, i enheten enheter, vannrett rulling. Denne parameteren må være en negativ verdi hvis du vil rulle til venstre.
dy
Angir hvor, i enheten enheter, loddrette rulling. Denne parameteren må være en negativ verdi for Rull opp.
prcScroll
Pekeren til den RECT -strukturen som angir delen av klientområdet som skal rulles. Hvis denne parameteren er NULL, rullet hele klientområdet.
prcClip
Pekeren til RECT strukturen som inneholder koordinatene for rektanglet klipping. Bare enheten biter innenfor rektanglet klipping påvirkes. BITS har bladd fra utsiden av rektanglet på innsiden er malt; biter bladd fra innsiden av rektanglet til utsiden er ikke malt.
hrgnUpdate
Håndtere i regionen som er modifisert for å holde regionen ugyldiggjort ved å rulle. Denne parameteren kan være NULL.
prcUpdate
Pekeren til RECT strukturen mottar grensene for rektanglet ugyldiggjort ved å rulle. Denne parameteren kan være NULL.
flagg
Angir flaggene som kontrollerer rulling. Denne parameteren kan være en av følgende verdier:
Verdi Betydning
SW_ERASE Sletter nylig ugyldige regionen ved å sende en WM_ERASEBKGND melding til vinduet når angitt med flagget SW_INVALIDATE.
SW_INVALIDATE Gjør ugyldig området identifisert med parameteren hrgnUpdate når du ruller.
SW_SCROLLCHILDREN Ruller alle underordnede vinduer som overlapper hverandre rektangel vises til i prcScroll -parameteren. De underordnede vinduene er rullet på antall piksler som er angitt av parameterne dx og dy . Systemet sender en WM_MOVE-melding til alle underordnede vinduer som krysser prcScroll rektanglet, selv om de ikke Flytt.
SW_SMOOTHSCROLL Windows NT 5.0 og senere: Ruller ved hjelp av jevn rulling. Bruk den HIWORD delen av parameteren flagg for å angi hvor mye tid jevn rulling operasjonen bør ta.

Returverdier

Hvis funksjonen lykkes, er returverdien SIMPLEREGION (ugyldige rektangulære området), COMPLEXREGION (ikke-rektangulær ugyldige regionen; overlappende rektangler) eller NULLREGION (ingen ugyldige region).

Hvis funksjonen mislykkes, er returverdien feil. Til å vise utvidet feilinformasjon, kan du ringe GetLastError.

Merknader

Hvis flaggene SW_INVALIDATE og SW_ERASE ikke er angitt, opphever ScrollWindowEx ikke er bladd frem fra området. Hvis en av disse flaggene er satt, gjør ScrollWindowEx ugyldig dette området. Området er ikke oppdatert til program-kall den UpdateWindow -funksjonen, samtaler den RedrawWindow funksjonen (som angir flagget RDW_UPDATENOW eller RDW_ERASENOW), eller henter WM_PAINT-meldingen fra programkøen.

Hvis vinduet har stilen WS_CLIPCHILDREN, representerer de returnerte områdene som er angitt av hrgnUpdate og prcUpdate det totale området av Rullevindauget som må oppdateres, inkludert eventuelle områder i underordnede vinduer som trenger oppdatering.

Hvis flagget SW_SCROLLCHILDREN er angitt, oppdaterer systemet riktig ikke skjermen hvis en del av et underordnet vindu rullet. Delen av vinduet scrolled barn, som ligger utenfor rektanglet kilde ikke er slettet, og tegnes ikke riktig i nye målet. Hvis du vil flytte underordnede vinduer som ikke ligger fullstendig innenfor rektanglet som er angitt av prcScroll, kan du bruke funksjonen DeferWindowPos . Markøren omplasseres hvis flagget SW_SCROLLCHILDREN er angitt og cirkumflekstegn rektanglet krysser bla-rektangel.

Alle inndata- og koordinatene (for prcScroll, prcClip, prcUpdateog hrgnUpdate) bestemmes som klienten koordinater, uavhengig av om vinduet har klasse i stilen CS_OWNDC eller CS_CLASSDC. Bruke funksjonene LPtoDP og DPtoLP til å konvertere til og fra logiske koordinater, om nødvendig.

Windows CE: Parameteren flagg støtter ikke SW_SCROLLCHILDREN.

Bare én av parameterne dx og dy kan være ikke-null.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.1 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Krever versjon 1.0 eller senere.
Topptekst:Deklarert i winuser.h.
Importere biblioteket:Bruk user32.lib.

Se også

Bla barer oversikt, rullefelt fungerer, DeferWindowPos, DPtoLP, LPtoDP, RECT, RedrawWindow, UpdateWindow

Index