GetScrollInfo

Funksjonen GetScrollInfo henter parameterne for et rullefelt, inkludert minimums- og maksimumsantallet rulling posisjoner, størrelsen på og plasseringen av rulleboksen (miniatyr).

BOOL GetScrollInfo) HWND  hwnd, / / håndtere til vinduet med rullefeltIntfnBar, / / rullefelt flaggLPSCROLLINFOlpsi / / peker til struktur for bla-parametere);
 

Parametere

hwnd
Håndtere til en Rull bar-kontroll eller et vindu med et standard rullefelt, avhengig av verdien for parameteren fnBar.
fnBar
Angir hvilken type rullefelt for å hente parametere. Denne parameteren kan være en av følgende verdier:
Verdi Betydning
SB_CTL Henter parameterne for en kontroll over rullingen bar. Hwnd -parameteren må være håndtaket til du har kontrollen over rullingen bar.
SB_HORZ Henter parametere for det angitte vinduet standard vannrett rullefelt.
SB_VERT Henter parametere for det angitte vinduet standard loddrett rullefelt.

lpsi
Pekeren til en SCROLLINFO struktur. Før du kaller GetScrollInfo, satt cbSize medlem av strukturen til sizeof(SCROLLINFO), og satt i fMask -medlemmet for å angi scroll bar parametere til å hente. Før retur kopierer funksjonen angitte parametere til de aktuelle medlemmene av strukturen.

FMask -medlem kan være en kombinasjon av følgende verdier:
Verdi Betydning
SIF_PAGE Kopier siden Bla til nPage medlem av SCROLLINFO -strukturen vises til i lpsi.
SIF_POS Kopier rulleplasseringen til nPos medlem av SCROLLINFO -strukturen vises til i lpsi.
SIF_RANGE Kopierer området bla til nMin og nMax medlemmer av SCROLLINFO -strukturen vises til i lpsi.
SIF_TRACKPOS Kopier gjeldende rulleboksen sporing posisjonen til nTrackPos medlem av SCROLLINFO -strukturen vises til i lpsi.

Returverdier

Hvis funksjonen hentet verdier, er returverdien ikke-null.

Hvis funksjonen ikke hente verdier, er returverdien null. Til å vise utvidet feilinformasjon, kan du ringe GetLastError.

Merknader

Funksjonen GetScrollInfo gjør det mulig for programmer å bruke 32-biters Bla stillinger. Selv om meldinger som angir plasseringen for rullefelt, WM_HSCROLL - og WM_VSCROLL, tilbyr bare 16 biter posisjonsdata, funksjonene, SetScrollInfo og GetScrollInfo gi 32 biter av rullefeltet posisjonsdata. Dermed kan et program kaller GetScrollInfo under behandling enten WM_HSCROLL eller WM_VSCROLL meldinger vil ha 32-biters-rullefeltet posisjonsdata.

For å få 32-biters plasseringen av rulleboksen (miniatyr) under en SB_THUMBTRACK-melding i en melding som WM_HSCROLL eller WM_VSCROLL, kan du ringe GetScrollInfo med SIF_TRACKPOS-verdien i fMask -medlem av SCROLLINFO -strukturen. Funksjonen returnerer sporing plasseringen av rulleboksen i nTrackPos -medlem av SCROLLINFO -strukturen. Dette tillater deg å få plasseringen av rulleboksen som brukeren flytter den. Følgende eksempelkode illustrerer teknikken.

SCROLLINFO si;
rettssak WM_HSCROLL:
    Switch(LOWORD(wParam)) {
        rettssak SB_THUMBTRACK:
          / / Initialisere SCROLLINFO struktur
 
            ZeroMemory (amp; si, sizeof(SCROLLINFO));
            si.cbSize = sizeof(SCROLLINFO);
            si.fMask = SIF_TRACKPOS;
 
          / / Call GetScrollInfo for å få gjeldende sporing / / plasser i si.nTrackPos
 
            if (!.GetScrollInfo(hwnd, SB_HORZ, &si))
                gå tilbake til 1; / / GetScrollInfo mislyktes
            Break;
        .
        .
        .
    } 

Hurtiginformasjon

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

Se også

Bla barer oversikt, rullefelt fungerer, SCROLLINFO, SetScrollInfo, WM_HSCROLL, WM_VSCROLL

Index