SetScrollRange

Funksjonen SetScrollRange angir minimum og maksimum posisjon verdiene for det angitte rullefeltet.

SetScrollRange -funksjonen er inkludert for bakoverkompatibilitet. Nye programmer bør bruke SetScrollInfo -funksjonen.

 BOOL SetScrollRange) HWND  hWnd, / / håndtere til vinduet med rullefeltIntnBar, / / rullefelt flaggIntnMinPos, / / minimum rulling posisjonIntnMaxPos, / / maksimal rulling posisjonBOOLbRedraw / / omtegne flagg);
 

Parametere

hWnd
Håndtere til en Rull bar-kontroll eller et vindu med et standard rullefelt, avhengig av verdien for parameteren nBar.
nBar
Angir rullefelt som skal angis. Denne parameteren kan være en av følgende verdier:
Verdi Betydning
SB_CTL Setter verdiområdet for en Rull bar-kontroll. HWnd -parameteren må være håndtaket til du har kontrollen over rullingen bar.
SB_HORZ Setter verdiområdet i et vindu standard vannrett rullefelt.
SB_VERT Angir området med et vindu standard loddrett rullefelt.

nMinPos
Angir minimum rulling posisjon.
nMaxPos
Angir maksimalt rulling posisjon.
bRedraw
Angir om rullefeltet bør tilbaketrekkes for å gjenspeile endringen. Hvis denne parameteren er sann, tegnes rullefeltet. Hvis den er FALSE, tegnes ikke rullefeltet.

Returverdier

Hvis funksjonen lykkes, er returverdien ikke-null.

Hvis funksjonen mislykkes, er verdien som returneres Null. Til å vise utvidet feilinformasjon, kan du ringe GetLastError.

Merknader

Du kan bruke SetScrollRange til å skjule rullefeltet ved innstillingen nMinPos og nMaxPos samme verdi. Et program må ikke kalle funksjonen SetScrollRange Hvis du vil skjule et rullefelt under behandling av en Rull bar-melding. Nye programmer bør bruke ShowScrollBar -funksjonen hvis du vil skjule rullefeltet.

Hvis kallet til SetScrollRange følger umiddelbart etter et kall til funksjonen SetScrollPos , må den bRedraw -parameteren i SetScrollPos være null for å hindre at rullefeltet trekkes to ganger.

Standardområdet for en standard rullefeltet er 0 til 100. Standardområdet for en kontroll over rullingen bar er tom (parameterverdier for både nMinPos og nMaxPos er null). Forskjellen mellom verdiene som er angitt av parameterne nMinPos og nMaxPos må ikke være større enn verdien for MAXLONG.

Fordi rapportmeldinger som angir plassering av bla, WM_HSCROLL og WM_VSCROLL, er begrenset til 16 biter av posisjonsdata, har programmer som stoler helt på disse meldingene for posisjonsdata en praktisk maksimumsverdi 65 535 for nMaxPos -parameteren i SetScrollRange -funksjonen.

Men fordi funksjonene SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPosog GetScrollRange støtter 32-biters scroll bar posisjonsdata, er det en måte å omgå 16-biters barrieren av WM_HSCROLL og WM_VSCROLL-meldinger. Se GetScrollInfo for en beskrivelse av teknikken.

Hurtiginformasjon

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

Se også

Rullefelt, oversikt, funksjoner for rullefelt, GetScrollInfo, GetScrollPos, GetScrollRange, SetScrollInfo, SetScrollPos, ShowScrollBar

Index