SetScrollInfo

Funkcja SetScrollInfo ustawia parametry przewijania pasek, włączając w to minimum i maksimum przewijanie położenie, rozmiar strony i pozycja pola przewijania (kciuk). Funkcja również odrysowania pasek przewijania na żądanie.

int SetScrollInfo ( HWND  hwnd, / / dojście do okna z paska przewijaniaintfnBar, / / przewiń pasek FlagaLPSCROLLINFOlpsi,  / / wskaźnik do struktury z parametrami przewijaniaBOOLfRedraw / / Odśwież Flaga);

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 ustawić parametry. Ten parametr może mieć jedną z następujących wartości:

Wartość	Znaczenie
SB_CTL	Ustawia parametry formantu pasek przewijania. Parametr hwnd musi być uchwyt sterowania pasek przewijania.
SB_HORZ	Ustawia parametry danym oknie standardowych przewijania poziomego paska.
SB_VERT	Ustawia parametry danym oknie standardowych przewijania pionowego paska.

lpsi

Wskaźnik do struktury SCROLLINFO . Przed wywołaniem metody SetScrollInfo, zestawu replik cbSize struktury do sizeof(SCROLLINFO), zestawu replik fMask , aby wskazać parametry do ustawiania i określić nowe wartości parametru w odpowiednich członków.

Element fMask może być kombinacją następujących wartości:

Wartość Znaczenie

SIF_DISABLENOSCROLL Wyłącza pasek przewijania zamiast usuwania go, jeśli parametry nowy pasek przewijania umożliwiają paska przewijania niepotrzebne.

SIF_PAGE Ustawia stronę przewijania do wartości określonej w elemencie nPage struktury SCROLLINFO wskazywanego przez lpsi.

SIF_POS Ustawia pozycję przewijania do wartości określonej w nienastawionych członkiem struktury SCROLLINFO wskazywanego przez lpsi.

SIF_RANGE Ustawia zakres przewijania do wartości określonej w nMin i członków nMax struktury SCROLLINFO wskazywanego przez lpsi.

fRedraw

Określa, czy pasek przewijania jest odświeżana, aby odzwierciedlić zmiany paska przewijania. Jeśli ten parametr ma wartość TRUE, pasek przewijania jest odświeżana, w przeciwnym razie nie jest odświeżana.

Wartość	Znaczenie
SIF_DISABLENOSCROLL	Wyłącza pasek przewijania zamiast usuwania go, jeśli parametry nowy pasek przewijania umożliwiają paska przewijania niepotrzebne.
SIF_PAGE	Ustawia stronę przewijania do wartości określonej w elemencie nPage struktury SCROLLINFO wskazywanego przez lpsi.
SIF_POS	Ustawia pozycję przewijania do wartości określonej w nienastawionych członkiem struktury SCROLLINFO wskazywanego przez lpsi.
SIF_RANGE	Ustawia zakres przewijania do wartości określonej w nMin i członków nMax struktury SCROLLINFO wskazywanego przez lpsi.

Zwraca wartości

Wartość zwracany jest bieżąca pozycja pola przewijania.

Uwagi

Funkcja SetScrollInfo wykonuje sprawdzanie wartości określonej przez nPage i nienastawionych konstrukcji SCROLLINFO zakresu. Członek nPage należy określić wartość z przedziału od 0 do nMax - nMin + 1. Członkowskie nienastawionych należy określić wartość z przedziału od nMin oraz nMax - max(nPage -1, 0). Jeśli jedną z tych wartości jest poza zasięgiem, funkcja ustawia jego wartość, która jest tylko w zakresie.

Systemu Windows CE: W systemie Windows CE 2.0 jeśli przekazanie wskaźnika zerowego w parametrze lpsi SetScrollInfo zwraca zera, raczej niż bieżąca pozycja pola przewijania.

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ż

Paski przewijania omówienie, funkcje paska przewijania, GetScrollInfo, SCROLLINFO