GetScrollInfo

Funkcja GetScrollInfo pobiera parametry przewijania pasek, włączając w to minimum i maksimum przewijanie położenie, rozmiar strony i pozycja pola przewijania (kciuk).

(BOOL GetScrollInfo HWND  hwnd, / / dojście do okna z paska przewijaniaintfnBar, / / przewiń pasek FlagaLPSCROLLINFOlpsi / / wskaźnik do struktury parametrów przewijania);
 

Parametry

hwnd
Dojście do formantu paska przewijania lub okno z paskiem przewijania standardowy, w zależności od wartości parametru fnBar.
fnBar
Określa typ paska przewijania, dla którego należy pobrać parametrów. Ten parametr może mieć jedną z następujących wartości:
Wartość Znaczenie
SB_CTL Pobiera parametry formantu pasek przewijania. Parametr hwnd musi być uchwyt sterowania pasek przewijania.
SB_HORZ Pobiera parametry danym oknie standardowych przewijania poziomego paska.
SB_VERT Pobiera parametry danym oknie standardowych przewijania pionowego paska.

lpsi
Wskaźnik do struktury SCROLLINFO . Przed wywołaniem metody GetScrollInfo, zestawu replik cbSize struktury do sizeof(SCROLLINFO) i zestawu replik fMask , aby określić parametry paska przewijania, aby pobrać. Przed zwróceniem, funkcja kopiuje określone parametry członkom odpowiednie struktury.

Element fMask może być kombinacją następujących wartości:
Wartość Znaczenie
SIF_PAGE Kopie stronę przewijania, aby członek nPage struktury SCROLLINFO wskazywanego przez lpsi.
SIF_POS Kopie przewijanie elementu członkowskiego nienastawionych strukturę SCROLLINFO , o którym wskazywanego przez lpsi.
SIF_RANGE Kopiuje zakres przewijania do nMin i członków nMax struktury SCROLLINFO wskazywanego przez lpsi.
SIF_TRACKPOS Kopie bieżące pole przewijania, śledzenia stanowisko członka nTrackPos struktury SCROLLINFO wskazywanego przez lpsi.

Zwraca wartości

Jeśli funkcja pobierane wartości, wartość zwracany jest różna od zera.

Jeśli funkcja nie pobiera żadnych wartości, wartość zwracany jest równa zero. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Funkcja GetScrollInfo umożliwia aplikacjom korzystanie pozycji przewijania 32-bitowych. Chociaż wiadomości, które wskazują położenie paska przewijania, WM_HSCROLL i WM_VSCROLL, zapewniają tylko 16 bitów danych pozycji, funkcje SetScrollInfo i GetScrollInfo 32 bity danych pozycji paska przewijania. W związku z tym aplikacja może wywołać GetScrollInfo podczas przetwarzania wiadomości WM_HSCROLL lub WM_VSCROLL do uzyskania danych pozycji paska przewijania 32-bitowy.

Aby uzyskać pozycję 32-bitowe pole przewijania (kciuk) podczas powiadomienie SB_THUMBTRACK w wiadomości WM_HSCROLL lub WM_VSCROLL, wywołanie GetScrollInfo z wartością SIF_TRACKPOS, członka fMask struktury SCROLLINFO . Funkcja zwraca pozycję śledzenia pole przewijania, członka nTrackPos struktury SCROLLINFO . Umożliwia uzyskanie pozycja pola przewijania użytkownik przenosi ją. Następujący przykładowy kod ilustruje techniki.

SCROLLINFO si;
Sprawa WM_HSCROLL:
    {Switch(LOWORD(wparam))}
        Sprawa SB_THUMBTRACK:
          / / Zainicjować struktury SCROLLINFO
 
            ZeroMemory (amp; si, sizeof(SCROLLINFO));
            si.cbSize = sizeof(SCROLLINFO);
            si.fMask = SIF_TRACKPOS;
 
          / / Wywołania GetScrollInfo Aby uzyskać bieżące śledzenie / pozycja w si.nTrackPos
 
            if (!.GetScrollInfo(hwnd, SB_HORZ, &si))
                zwrócona wartość 1; / / GetScrollInfo nie powiodło się
            podział;
        .
        .
        .
    } 

Skrócone informacje

nbsp; Windows &NT: wymaga wersji 3.51 lub nowszych.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Użycie user32.lib.

Zobacz też

Przewiń paski omówienie, funkcje paska przewijania, SCROLLINFO, SetScrollInfo, WM_HSCROLL, WM_VSCROLL

Index