SetScrollPos

Funkcję SetScrollPos ustawia pozycję pole przewijania (kciuk) na pasku przewijania określony i, jeśli wymagane, odrysowania paska przewijania, aby odzwierciedlić nowe położenie pola przewijania.

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

int SetScrollPos ( HWND  hWnd, / / dojście do okna z paska przewijaniaintnBar, / / przewiń pasek Flagaintnienastawionych, / / Nowa pozycja pola przewijaniaBOOLbRedraw / / 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 pozycję pole przewijania w formancie pasek przewijania. Parametr hWnd musi być uchwyt sterowania pasek przewijania.
SB_HORZ Ustawia pozycję pole przewijania w oknie standardowych przewijania poziomego paska.
SB_VERT Ustawia pozycję pole przewijania w oknie standardowych przewijania pionowego paska.

nienastawionych
Określa nowe położenie pola przewijania. Stanowisko musi mieścić zakres przewijania. Aby uzyskać więcej informacji o zakresie przewijania zobacz opis funkcji SetScrollRange.
bRedraw
Określa, czy pasek przewijania jest odświeżana, aby odzwierciedlić nowe pozycja pola przewijania. 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 poprzednim pozycja pola przewijania.

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

Uwagi

Jeśli pasek przewijania jest rysowane przez kolejne wywołanie innej funkcji, ustawienie parametru bRedraw na FALSE jest przydatne.

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 nienastawionych funkcji SetScrollPos 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, SetScrollRange

Index