Pasek przewijania

Ta sekcja zawiera informacje o elementach programowania używanych z paskami przewijania. Okno może wyświetlać obiekt danych, taki jak dokument lub mapa bitowa, który jest większy niż obszar klienta okna. Po podaniu paska przewijania użytkownik może przewinąć obiekt danych w obszarze klienta, aby wyświetlić części obiektu, które wykraczają poza granice okna.

Przeglądy

Temat	Treść
o paskach przewijania	Pasek przewijania składa się z zacienionego wału z przyciskiem strzałki na każdym końcu i pole przewijania (czasami nazywane kciukiem) między przyciskami strzałek.
przy użyciu pasków przewijania	Podczas tworzenia nakładających się okien podręcznych lub podrzędnych można dodać standardowe paski przewijania przy użyciu funkcji CreateWindowExCreateWindowEx i określania WS_HSCROLL, WS_VSCROLLlub obu stylów.

Funkcje

Temat	Treść
EnableScrollBar	Funkcja EnableScrollBar włącza lub wyłącza jedną lub obie strzałki paska przewijania.
getScrollBarInfo	Funkcja GetScrollBarInfo pobiera informacje o określonym pasku przewijania.
GetScrollInfo	Funkcja GetScrollInfo pobiera parametry paska przewijania, w tym minimalne i maksymalne pozycje przewijania, rozmiar strony i położenie pola przewijania (kciuk).
GetScrollPos	Funkcja GetScrollPos pobiera bieżące położenie pola przewijania (kciuka) na określonym pasku przewijania. Bieżące położenie jest wartością względną, która zależy od bieżącego zakresu przewijania. Jeśli na przykład zakres przewijania wynosi od 0 do 100, a pole przewijania znajduje się w środku paska, bieżąca pozycja to 50. Uwaga: funkcja GetScrollPos jest udostępniana w celu zapewnienia zgodności z poprzednimi wersjami. Nowe aplikacje powinny używać funkcji GetScrollInfo.
GetScrollRange	Funkcja GetScrollRange pobiera bieżące minimalne i maksymalne położenia pola przewijania (kciuka) dla określonego paska przewijania. Uwaga: funkcja GetScrollRange jest udostępniana tylko pod kątem zgodności. Nowe aplikacje powinny używać funkcji GetScrollInfo.
ScrollDC	Funkcja ScrollDC przewija prostokąt bitów w poziomie i w pionie.
Przewińwindow	Funkcja ScrollWindow przewija zawartość obszaru klienta określonego okna. Uwaga: funkcja ScrollWindowjest udostępniana w celu zapewnienia zgodności z poprzednimi wersjami. Nowe aplikacje powinny używać funkcji ScrollWindowEx.
ScrollWindowEx	Funkcja ScrollWindowEx przewija zawartość obszaru klienta określonego okna.
SetScrollInfo	Funkcja SetScrollInfo ustawia parametry paska przewijania, w tym minimalne i maksymalne pozycje przewijania, rozmiar strony i położenie pola przewijania (kciuk). Funkcja również ponownie rysuje pasek przewijania, jeśli jest to wymagane.
SetScrollPos	Funkcja SetScrollPos ustawia położenie pola przewijania (kciuka) na określonym pasku przewijania i, jeśli jest to wymagane, ponownie rysuje pasek przewijania, aby odzwierciedlić nową pozycję pola przewijania. Uwaga: funkcja SetScrollPos jest udostępniana w celu zapewnienia zgodności z poprzednimi wersjami. Nowe aplikacje powinny używać funkcjiSetScrollInfo.
SetScrollRange	Funkcja SetScrollRange ustawia minimalne i maksymalne pozycje pól przewijania dla określonego paska przewijania. Uwaga: funkcja SetScrollRange jest udostępniana w celu zapewnienia zgodności z poprzednimi wersjami. Nowe aplikacje powinny używać funkcjiSetScrollInfo.
ShowScrollBar	Funkcja ShowScrollBar pokazuje lub ukrywa określony pasek przewijania.

Wiadomości

Temat	Treść
SBM_ENABLE_ARROWS	Aplikacja wysyła komunikat SBM_ENABLE_ARROWS, aby włączyć lub wyłączyć jedną lub obie strzałki kontrolki paska przewijania.
SBM_GETPOS	Komunikat SBM_GETPOS jest wysyłany w celu pobrania bieżącej pozycji pola przewijania kontrolki paska przewijania. Bieżące położenie jest wartością względną, która zależy od bieżącego zakresu przewijania. Jeśli na przykład zakres przewijania wynosi od 0 do 100, a pole przewijania znajduje się w środku paska, bieżąca pozycja to 50. Aplikacje nie powinny wysyłać tej wiadomości bezpośrednio. Zamiast tego należy użyć funkcji GetScrollPos. Okno odbiera ten komunikat za pośrednictwem funkcji WindowProc. Aplikacje, które implementują niestandardową kontrolkę paska przewijania, muszą odpowiadać na te komunikaty, aby funkcja GetScrollPos działała prawidłowo.
SBM_GETRANGE	Komunikat SBM_GETRANGE jest wysyłany w celu pobrania minimalnych i maksymalnych wartości pozycji dla kontrolki paska przewijania. Aplikacje nie powinny wysyłać tej wiadomości bezpośrednio. Zamiast tego należy użyć funkcji GetScrollRange. Okno odbiera ten komunikat za pośrednictwem funkcji WindowProc. Aplikacje, które implementują niestandardową kontrolkę paska przewijania, muszą odpowiadać na te komunikaty, aby funkcja GetScrollRange działała prawidłowo.
SBM_GETSCROLLBARINFO	Wysłane przez aplikację w celu pobrania informacji o określonym pasku przewijania.
SBM_GETSCROLLINFO	Komunikat SBM_GETSCROLLINFO jest wysyłany w celu pobrania parametrów paska przewijania. Aplikacje nie powinny wysyłać tej wiadomości bezpośrednio. Zamiast tego należy użyć funkcjiGetScrollInfo. Okno odbiera ten komunikat za pośrednictwem funkcji WindowProc. Aplikacje, które implementują niestandardową kontrolkę paska przewijania, muszą odpowiadać na te komunikaty, aby funkcja GetScrollInfo działała prawidłowo.
SBM_SETPOS	Komunikat SBM_SETPOS jest wysyłany, aby ustawić położenie pola przewijania (kciuk) i, jeśli jest to wymagane, ponownie narysuj pasek przewijania, aby odzwierciedlić nową pozycję pola przewijania. Aplikacje nie powinny wysyłać tej wiadomości bezpośrednio. Zamiast tego należy użyć funkcji SetScrollPos. Okno odbiera ten komunikat za pośrednictwem funkcji WindowProc. Aplikacje, które implementują niestandardową kontrolkę paska przewijania, muszą odpowiadać na te komunikaty, aby funkcja SetScrollPos działała prawidłowo.
SBM_SETRANGE	Komunikat SBM_SETRANGE jest wysyłany w celu ustawienia wartości minimalnej i maksymalnej pozycji dla kontrolki paska przewijania. Aplikacje nie powinny wysyłać tej wiadomości bezpośrednio. Zamiast tego należy użyć funkcji SetScrollRange. Okno odbiera ten komunikat za pośrednictwem funkcji WindowProc. Aplikacje, które implementują niestandardową kontrolkę paska przewijania, muszą odpowiadać na te komunikaty, aby funkcja SetScrollRange działała prawidłowo.
SBM_SETRANGEREDRAW	Aplikacja wysyła komunikat SBM_SETRANGEREDRAW do kontrolki paska przewijania, aby ustawić wartości minimalnej i maksymalnej pozycji oraz ponownie wyrysować kontrolkę.
SBM_SETSCROLLINFO	Komunikat SBM_SETSCROLLINFO jest wysyłany w celu ustawienia parametrów paska przewijania. Aplikacje nie powinny wysyłać tej wiadomości bezpośrednio. Zamiast tego należy użyć funkcjiSetScrollInfoSetScrollInfo. Okno odbiera ten komunikat za pośrednictwem funkcji WindowProc. Aplikacje, które implementują niestandardową kontrolkę paska przewijania, muszą odpowiadać na te komunikaty, aby funkcja SetScrollInfo działała prawidłowo.

Powiadomienia

Temat	Treść
WM_CTLCOLORSCROLLBAR	Komunikat WM_CTLCOLORSCROLLBAR jest wysyłany do okna nadrzędnego kontrolki paska przewijania, gdy kontrolka ma zostać narysowana. Odpowiadając na ten komunikat, okno nadrzędne może użyć uchwytu kontekstu wyświetlania, aby ustawić kolor tła kontrolki paska przewijania. Okno odbiera ten komunikat za pośrednictwem funkcji WindowProc.
WM_HSCROLL	Komunikat WM_HSCROLL jest wysyłany do okna, gdy zdarzenie przewijania występuje na standardowym pasku przewijania w poziomie okna. Ten komunikat jest również wysyłany do właściciela kontrolki paska przewijania poziomego po wystąpieniu zdarzenia przewijania w kontrolce. Okno odbiera ten komunikat za pośrednictwem funkcji WindowProc.
WM_VSCROLL	Komunikat WM_VSCROLL jest wysyłany do okna, gdy zdarzenie przewijania występuje na standardowym pasku przewijania okna w pionie. Ten komunikat jest również wysyłany do właściciela kontrolki pionowego paska przewijania po wystąpieniu zdarzenia przewijania w kontrolce. Okno odbiera ten komunikat za pośrednictwem funkcji WindowProc.

Struktur

Temat	Treść
SCROLLBARINFO	Struktura SCROLLBARINFO zawiera informacje o pasku przewijania.
SCROLLINFO	StrukturaSCROLLINFO zawiera parametry paska przewijania, które mają być ustawiane przez funkcjęSetScrollInfo (lub komunikat SBM_SETSCROLLINFO) lub pobieraną przez funkcję GetScrollInfo (lub komunikat SBM_GETSCROLLINFO).

Stałe

Temat

Treść

style kontrolek paska przewijania

Aby utworzyć kontrolkę paska przewijania przy użyciu CreateWindow lub funkcji CreateWindowEx określ klasę SCROLLBAR, odpowiednie stałe stylu okna i kombinację następujących stylów kontrolek paska przewijania. Niektóre style tworzą kontrolkę paska przewijania, która używa domyślnej szerokości lub wysokości. Należy jednak zawsze określić współrzędne x i y oraz inne wymiary paska przewijania podczas wywoływania polecenia CreateWindow lub CreateWindowEx.