SetScrollRange

Funkcja SetScrollRange ustawia wartości minimalne i maksymalne pozycji paska przewijania określonego.

Funkcja SetScrollRange jest zapewnić zgodność ze starszymi wersjami. Nowe aplikacje powinny używać funkcji SetScrollInfo.

 (BOOL SetScrollRange HWND  hWnd, / / dojście do okna z paska przewijaniaintnBar, / / przewiń pasek FlagaintnMinPos, / / minimalne przewijanie stanowiskointnMaxPos, / / maksymalna, przewijanie stanowiskoBOOLbRedraw / / 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 nBar.
nBar
Określa pasek przewijania mają zostać ustalone. Ten parametr może mieć jedną z następujących wartości:
Wartość Znaczenie
SB_CTL Ustawia zakres kontroli pasek przewijania. Parametr hWnd musi być uchwyt sterowania pasek przewijania.
SB_HORZ Ustawia zakres oknie standardowych przewijania poziomego paska.
SB_VERT Ustawia zakres oknie standardowych przewijania pionowego paska.

nMinPos
Określa minimalny przewijanie stanowisko.
nMaxPos
Określa maksymalną przewijanie stanowisko.
bRedraw
Określa, czy jest odświeżana paska przewijania, aby odzwierciedlać zmiany. Jeśli ten parametr ma wartość TRUE, pasek przewijania jest odświeżana. Jeżeli ma wartość FAŁSZ, paska przewijania nie jest odświeżana.

Zwraca wartości

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

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

Uwagi

Aby ukryć pasek przewijania przez ustawienie nMinPos i nMaxPos na tę samą wartość, można użyć SetScrollRange . Aplikacja nie powinna wywołać funkcję SetScrollRange , aby ukryć pasek przewijania podczas przetwarzania wiadomości pasek przewijania. Nowe aplikacje powinny używać funkcji ShowScrollBar aby ukryć pasek przewijania.

Jeśli wywołanie SetScrollRange natychmiast następuje po wywołaniu funkcji SetScrollPos , parametr bRedraw w SetScrollPos musi mieć wartość zero, aby zapobiec rysowana dwukrotnie pasek przewijania.

Domyślny zakres dla paska przewijania standardowych jest 0 do 100. Domyślny zakres kontroli pasek przewijania jest pusta ( nMinPos i nMaxPos wartości parametrów są zera). Różnica między wartościami określonymi przez parametry nMinPos i nMaxPos nie może być większa niż wartość wartość MAXLONG.

Ponieważ komunikaty, które wskazują położenie paska przewijania, WM_HSCROLL i WM_VSCROLL, są ograniczone do 16 bitów danych pozycji, aplikacje, które opierają się wyłącznie na te wiadomości dla danych pozycji mają praktyczne maksymalnej wartości dla parametru nMaxPos funkcji SetScrollRange do 65 535.

Jednak ponieważ SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPosi GetScrollRange funkcje obsługi danych pozycji paska przewijania 32-bitowe, istnieje sposób obejścia bariery 16-bitowe wiadomości WM_HSCROLL i WM_VSCROLL. Opis techniki patrz GetScrollInfo.

Skrócone informacje

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

Zobacz też

Paski przewijania omówienie, funkcje paska przewijania, GetScrollInfo, GetScrollPos, GetScrollRange, SetScrollInfo, SetScrollPos, ShowScrollBar

Index