SetScrollRange

De functie SetScrollRange stelt de positie van de minimale en maximale waarden voor de opgegeven schuifbalk.

De SetScrollRange functie is opgenomen voor achterwaartse compatibiliteit. Nieuwe toepassingen gebruikmaken van de functie SetScrollInfo.

 BOOL SetScrollRange ()  HWND  hWnd, / / verwerken naar venster met schuifbalkenintnBar, / / schuifbalk vlagintnMinPos, / / minimum scrollen positieintnMaxPos, / / maximum positie schuivenBOOLbRedraw / / vlag opnieuw tekenen);
 

Parameters

hWnd
Ingang naar een besturingselement scroll bar of een venster met een standaard schuifbalk, afhankelijk van de waarde van de parameter nBar.
nBar
Hiermee geeft u de schuifbalk moet worden ingesteld. Deze parameter kan een van de volgende waarden worden:
Waarde Betekenis
SB_CTL Het bereik van een scroll bar besturingselement ingesteld. De hWnd parameter moet de ingang naar de scroll bar control.
SB_HORZ Hiermee stelt u het bereik van een venster standaard horizontale schuifbalk.
SB_VERT Hiermee stelt u het bereik van een venster Standaard verticale schuifbalk.

nMinPos
Hiermee geeft u het minimum scrollen positie.
nMaxPos
Geeft u de maximum positie schuiven.
bRedraw
Hiermee geeft u aan of de schuifbalk aan de verandering opnieuw moet worden getekend. Als deze parameter TRUE is, wordt de schuifbalk opnieuw getekend. Als het onwaar is, de schuifbalk niet opnieuw wordt getekend.

Retourwaarden

Als de functie slaagt, is de retourwaarde aan nul.

Als de functie mislukt, is de retourwaarde nul. Te krijgen uitgebreide foutinformatie, Bel GetLastError.

Opmerkingen

U kunt SetScrollRange gebruiken om te verbergen de schuifbalk door de instelling nMinPos en nMaxPos op dezelfde waarde. Een toepassing moet niet de SetScrollRange functie aanroepen om te verbergen van een schuifbalk weergegeven tijdens het verwerken van een bericht scroll bar. Nieuwe toepassingen moeten de functie ShowScrollBar gebruiken om te verbergen de schuifbalk.

Als de aanroep van SetScrollRange onmiddellijk een aanroep naar de functie van SetScrollPos volgt , moet de bRedraw parameter in SetScrollPos nul om te voorkomen dat de schuifbalk wordt tweemaal getrokken.

Het standaard bereik voor een schuifbalk standaard is 0 tot en met 100. Het standaard bereik voor een scroll bar besturingselement leeg is (zowel de nMinPos als nMaxPos parameterwaarden zijn nul). Het verschil tussen de waarden die zijn opgegeven door de parameters nMinPos en nMaxPos moet niet groter zijn dan de waarde van MAXLONG.

Omdat de berichten die bar schuifpositie, WM_HSCROLL en WM_VSCROLL aangeven, beperkt tot 16-bits van gegevens over posities zijn, hebben toepassingen die uitsluitend op deze berichten voor positiegegevens een praktische maximale waarde van 65.535 voor parameter van de functie van de SetScrollRange nMaxPos.

Omdat de SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPosen GetScrollRange functies 32-bits scroll bar positiegegevens ondersteunen, is er echter een manier om te omzeilen de 16-bits barričre van de WM_HSCROLL en WM_VSCROLL weergegeven. Zie GetScrollInfo voor een beschrijving van de techniek.

Syntaxisinfo

nbsp; Windows &NT: versie 3.1 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Versie 2.0 of hoger vereist.
Header:Verklaard in winuser.h.
Bibliotheek importeren:User32.lib gebruiken.

Zie ook

Schuifbalken overzicht, schuifbalk functies, GetScrollInfo, GetScrollPos, GetScrollRange, SetScrollInfo, SetScrollPos, ShowScrollBar

Index