Scroll vak positie en scrollen bereik

De positie van het schuifblokje wordt weergegeven als een geheel getal; het is ten opzichte van de linker- of bovenste einde van de schuifbalk, afhankelijk van of de schuifbalk horizontaal of verticaal is. De situatie moet binnen de minimale en maximale waarden van de lichtkranttekst bereik. Bijvoorbeeld, in een schuifbalk met een bereik van 0 tot 100 is 50 positie in het midden, met de resterende posities gelijkelijk verdeeld langs de schuifbalk. Het eerste bereik is afhankelijk van de schuifbalk. Standaard schuifbalken hebben een eerste bereik van 0 tot en met 100; scroll bar besturingselementen hebben een leeg bereik (zowel minimale en maximale waarden nul zijn), tenzij u een expliciete bereik opgeven wanneer het besturingselement wordt gemaakt. U kunt het bereik op elk gewenst moment wijzigen. U kunt de functie SetScrollInfo de reeks waarden instellen, en de GetScrollInfo -functie voor het ophalen van waarden voor het huidige.

Een toepassing meestal past het bereik scroll tot handige gehele getallen, waardoor het gemakkelijk is om te vertalen de schuifpositie vak in een waarde die overeenkomt met het gegevensobject moet worden geschoven. Bijvoorbeeld, als een toepassing 260 lijnen van een tekstbestand in een venster dat slechts 16 lijnen tegelijk weergeven weergeven moet kunt, kan de verticale schuifbalk bar bereik worden ingesteld op 1 via 244. Als het schuifblokje op positie 1 is, zullen de eerste regel boven aan het venster. Als het schuifblokje op positie 244 is, zal de laatste regel (lijn 260) worden aan de onderkant van het venster. Als een toepassing probeert een positiewaarde die kleiner is dan het minimum of meer dan de maximaal op te geven, wordt de minimale of maximale scrollen bereik-waarde in plaats daarvan gebruikt.

U kunt de paginagrootte van een voor een schuifbalk instellen. De paginagrootte van de vertegenwoordigt het aantal gegevenseenheden van de dat in het clientgebied van het venster van de eigenaar zijn huidige grootte gegeven past. Bijvoorbeeld, als de client area 16 lijnen van tekst houden kan, zou een toepassing het paginaformaat ingesteld op 16. Het systeem gebruikt het paginaformaat, samen met de lichtkranttekst bereik en de lengte van de scroll schacht, instellen van de grootte van het schuifblokje. Wanneer het formaat van een venster met een schuifbalk een toepassing moet de SetScrollInfo functie aanroepen om te het paginaformaat instellen. Een toepassing kan het huidige paginaformaat ophalen door de verzendende GetScrollInfo functie.

Om een nuttige samenwerking tussen de scroll bar bereik en het gegevensobject, moet een toepassing het bereik aanpassen telkens wanneer de grootte van de gegevens bezwaar wijzigingen.

Als de gebruiker het schuifblokje in een schuifbalk beweegt, meldt de schuifbalk de vak schuifpositie als een geheel getal in het bereik scrollen. Als de positie de minimale waarde is, is het schuifblokje boven aan een verticale schuifbalk of de links op een horizontale schuifbalk. Als de positie de maximale waarde is, is het schuifblokje aan de onderkant van een verticale schuifbalk of rechts op een horizontale schuifbalk.

De maximale waarde die een schuifbalk kan verslag (dat wil zeggen de maximale scrollen positie) is afhankelijk van het paginaformaat. Als de schuifbalk een paginaformaat groter is dan één heeft, is de maximale scrollen positie lager is dan de waarde van de maximale bereik. U kunt de volgende formule voor het berekenen van de maximale scrollen positie:

MaxScrollPos = MaxRangeValue-(PageSize - 1) 
 

Een toepassing moet het schuifblokje in een schuifbalk verplaatsen. Hoewel de gebruiker een verzoek maakt voor schuiven in een schuifbalk, wordt de schuifbalk niet automatisch bijgewerkt de schuifpositie vak. In plaats daarvan het verzoek wordt doorgegeven aan het bovenliggende venster, die moet de schuifpositie vak bijwerken en de gegevens schuiven. Een toepassing gebruikt de SetScrollInfo functie bijwerken de schuifpositie vak; anders wordt het de SetScrollPos functie gebruikt. Omdat het regelt het verkeer vak scroll, kunt de toepassing het schuifblokje in stappen die het beste werkt voor de gegevens wordt verschoven verplaatsen.

Index