GetScrollInfo

De GetScrollInfo functie haalt de parameters van de schuifbalk, met inbegrip van de minimum en maximum scrollen posities, het paginaformaat en de positie van het schuifblokje (duim).

BOOL GetScrollInfo ()  HWND  hwnd, / / verwerken naar venster met schuifbalkenintfnBar, / / schuifbalk vlagLPSCROLLINFOlpsi / / aanwijzer structuur voor scroll parameters);
 

Parameters

hwnd
Ingang naar een besturingselement scroll bar of een venster met een standaard schuifbalk, afhankelijk van de waarde van de parameter fnBar.
fnBar
Hiermee geeft u het type van de schuifbalk waarvoor parameters ophalen. Deze parameter kan een van de volgende waarden worden:
Waarde Betekenis
SB_CTL De parameters voor een scroll bar besturingselement opgehaald. De hwnd parameter moet de ingang naar de scroll bar control.
SB_HORZ Haalt de parameters voor het opgegeven venster de standaard horizontale schuifbalk.
SB_VERT De parameters voor standaard verticale schuifbalk van het opgegeven venster opgehaald.

lpsi
Aanwijzer naar een SCROLLINFO structuur. Voor het aanroepen van GetScrollInfo, ingesteld de cbSize lid van de structuur op sizeof(SCROLLINFO), en lid van de fMask de scroll bar parameters om op te halen op te geven. Alvorens terug te keren kopieert de functie het opgegeven parameters naar de juiste leden van de structuur.

Lid van de fMask kunnen een combinatie van de volgende waarden:
Waarde Betekenis
SIF_PAGE KopieŽn de scroll pagina de nPage lid van de SCROLLINFO structuur waarnaar door lpsi.
SIF_POS KopieŽn de schuifpositie de vzw lid van de SCROLLINFO structuur waarnaar door lpsi.
SIF_RANGE Kopieert het bereik scroll naar de nMin en nMax leden van de SCROLLINFO structuur waarnaar wordt verwezen door lpsi.
SIF_TRACKPOS KopieŽn het schuifblokje huidige positie bijhouden van het lid nTrackPos van de SCROLLINFO structuur waarnaar door lpsi.

Retourwaarden

Als de functie waarden opgehaald, is de retourwaarde aan nul.

Als de functie niet alle waarden ophaalt doet, is de retourwaarde nul. Te krijgen uitgebreide foutinformatie, Bel GetLastError.

Opmerkingen

De GetScrollInfo functie maakt gebruik van 32-bits scroll posities toepassingen. Hoewel de berichten die schuifbalk positie, WM_HSCROLL en WM_VSCROLL aangeven, uitsluitend 16-bits van gegevens over posities, de functies SetScrollInfo bieden en GetScrollInfo bieden 32 bits van positiegegevens scroll-bar. Dus, kan een toepassing GetScrollInfo bellen tijdens het verwerken van de WM_HSCROLL of de WM_VSCROLL berichten om 32-bits-schuifbalk positiegegevens te verkrijgen.

Bel GetScrollInfo om de 32-bits positie van het schuifblokje (duim) tijdens een kennisgeving van SB_THUMBTRACK in een WM_HSCROLL of WM_VSCROLL-bericht, met de waarde SIF_TRACKPOS in het fMask lid van de SCROLLINFO structuur. De functie retourneert de tracking positie van het schuifblokje in het lid nTrackPos van de SCROLLINFO structuur. U kunt de positie van het schuifblokje krijgen als de gebruiker verplaatst. De volgende voorbeeldcode illustreert de techniek.

SCROLLINFO si;
Case WM_HSCROLL:
    {switch(LOWORD(wParam))}
        Case SB_THUMBTRACK:
          / / SCROLLINFO structuur initialiseren
 
            ZeroMemory (amp; si, sizeof(SCROLLINFO));
            si.cbSize = sizeof(SCROLLINFO);
            si.fMask = SIF_TRACKPOS;
 
          / / Call GetScrollInfo om huidige bijhouden / / positie in si.nTrackPos
 
            If (!.GetScrollInfo(hwnd, SB_HORZ, &si))
                return 1; / / GetScrollInfo mislukt
            breken;
        .
        .
        .
    } 

Syntaxisinfo

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

Zie ook

Scroll Bars overzicht, schuifbalk functioneert, SCROLLINFO, SetScrollInfo, WM_HSCROLL, WM_VSCROLL

Index