SetScrollPos

De functie SetScrollPos wordt de positie van het schuifblokje (duim) ingesteld in de opgegeven schuifbalk en, desgevraagd, hertekent de schuifbalk aangepast aan de nieuwe positie van het schuifblokje.

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

int () SetScrollPos HWND  hWnd, / / verwerken naar venster met schuifbalkenintnBar, / / schuifbalk vlagintvzw, / / nieuwe positie van het schuifblokjeBOOLbRedraw / / 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 De positie van het schuifblokje in een scroll bar besturingselement ingesteld. De hWnd parameter moet de ingang naar de scroll bar control.
SB_HORZ Hiermee stelt u de positie van het schuifblokje in de standaard horizontale schuifbalk van een venster.
SB_VERT Hiermee stelt u de positie van het schuifblokje in standaard verticale schuifbalk van een venster.

vzw
Hiermee geeft u de nieuwe positie van het schuifblokje. De positie moet binnen de lichtkranttekst bereik. Zie voor meer informatie over het scrollen bereik, de SetScrollRange -functie.
bRedraw
Hiermee geeft u aan of de schuifbalk aangepast aan de nieuwe scroll vak positie opnieuw wordt 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 geretourneerde waarde de vorige positie van het schuifblokje.

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

Opmerkingen

Als de schuifbalk wordt opnieuw getekend door een volgende aanroep naar een andere functie, is de parameter bRedraw instelt op FALSE nuttig.

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 SetScrollPos vzw.

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, SetScrollRange

Index