GetScrollInfo

Funcţia GetScrollInfo preia parametrii de o defilare bar, inclusiv minim şi maxim scrolling poziţii, dimensiunea paginii şi poziţia de caseta de defilare (degetul mare).

(BOOL GetScrollInfo HWND  hwnd, / / ocupa fereastra cu bară de defilareintfnBar, / / scroll bar pavilionLPSCROLLINFOlpsi / / indicatorul structura pentru parametrii de defilare);
 

Parametrii

hwnd

Ocupa un control bară de defilare sau o fereastră cu o bară de defilare standard, în funcţie de valoarea din parametrul fnBar.

fnBar

Specifică tipul de bara de defilare pentru a prelua parametri. Acest parametru poate fi una dintre următoarele valori:

Valoarea	Sensul
SB_CTL	Preia parametrii de control bară de defilare. Parametrul hwnd trebuie să fie ghidajul de control bară de defilare.
SB_HORZ	Preia parametri pentru bara de defilare orizontală standard fereastra dat.
SB_VERT	Preia parametrii pentru fereastra dat standard bara de defilare verticală.

lpsi

Indicator spre o structură SCROLLINFO . Înainte de asteptare GetScrollInfo, setaţi membru cbSize structurii la sizeof(SCROLLINFO), şi setaţi fMask membre să specificaţi parametrii de bara de defilare pentru a prelua. Înainte de a reveni, funcţia copiază parametrii specificate adecvate membrilor structura.

Membru fMask poate fi o combinaţie de următoarele valori:

Valoarea	Sensul
SIF_PAGE	Copii pagina Parcurgere membru nPage din structura SCROLLINFO subliniat de lpsi.
SIF_POS	Copii pozi?ia defilare membru nPos din structura SCROLLINFO subliniat de lpsi.
SIF_RANGE	Copiază zona de defilare nMin şi nMax membrii structurii SCROLLINFO a subliniat de lpsi.
SIF_TRACKPOS	Copii curentă la caseta de defilare de urmărire poziţia membru nTrackPos din structura SCROLLINFO subliniat de lpsi.

Valorile întroarse

Dacă funcţia adus orice valori, valoarea returnată este nenul.

Dacă funcţia nu prelua orice valori, valoarea returnată este zero. Pentru a obţine extins informa?ii eroare, apel GetLastError.

Observaţii

Funcţia de GetScrollInfo permite aplicaţiilor să utilizeze poziţii defilare pe 32 de biţi. De?i mesajele care indică pozi?ia de bara de defilare, WM_HSCROLL şi WM_VSCROLL, oferă doar 16 biţi datelor, funcţiile SetScrollInfo şi GetScrollInfo oferă 32 biţi datelor bara de defilare. Astfel, cererea poate numi GetScrollInfo în timp ce prelucrare mesaje WM_HSCROLL sau WM_VSCROLL pentru a obţine date poziţia 32-bit scroll-bar.

Pentru a obţine poziţia pe 32 de biţi de caseta de defilare (degetul mare) în timpul o notificare de SB_THUMBTRACK într-un mesaj WM_HSCROLL sau WM_VSCROLL, apel GetScrollInfo cu valoarea SIF_TRACKPOS membru fMask de structura SCROLLINFO . Funcţia întoarce poziţia urmărire de caseta de defilare în membre nTrackPos de structura SCROLLINFO . Acest lucru vă permite să obţineţi pozi?ia caseta de defilare ca utilizatorul mută. Codul e?antionului următor ilustrează tehnica.

SCROLLINFO si;
cazul WM_HSCROLL:
    Switch(LOWORD(wparam)) {}
        cazul SB_THUMBTRACK:
          / / Ini?ializat structura SCROLLINFO
 
            ZeroMemory (amp; si, sizeof(SCROLLINFO));
            si.cbSize = sizeof(SCROLLINFO);
            si.fMask = SIF_TRACKPOS;
 
          / / Apel GetScrollInfo pentru a obţine curent urmărire / / poziţia în si.nTrackPos
 
            if (!.GetScrollInfo(hwnd, SB_HORZ, &si))
                Întoarce 1; / / GetScrollInfo nu a reuşit
            pauză;
        .
        .
        .
    } 

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.51 sau o versiune ulterioară.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Necesită versiunea 1.0 sau mai târziu.
Antet:A declarat în winuser.h.
Import Biblioteca:Utilizarea user32.lib.

A se vedea, de asemenea

Defila baruri prezentare generală, funcţii bara de defilare, SCROLLINFO, SetScrollInfo, WM_HSCROLL, WM_VSCROLL

Index