ScrollWindow

Funkcja ScrollWindow przewija zawartość obszaru klienta określonego okna. Funkcja ScrollWindow istnieje zgodność ze starszymi wersjami. Nowe aplikacje powinny używać funkcji ScrollWindowEx.

(BOOL ScrollWindow HWND  hWnd, / / dojście do okna do przewijaniaintXAmount, / / kwota poziome przewijanieintYAmount, / / kwota pionowe przewijanie Stała RECT* lpRect,  / / adresu struktury z przewijania prostokątStała RECT* lpClipRect / / adresu struktury z klipu prostokąt);
 

Parametry

hWnd

Dojście do okna, w którym obszaru klienckiego ma być przewijane.

XAmount

Określa ilość w jednostkach urządzenia, przewijania poziomego. Jeśli okno jest przewijane zostało zapisane w stylu CS_OWNDC lub CS_CLASSDC, ten parametr używa jednostek logicznych, zamiast urządzenia jednostek. Ten parametr musi być wartością ujemną aby przewinąć zawartość okna w lewo.

YAmount

Określa wysokość, w jednostkach urządzenia, pionowe paski przewijania. Jeśli okno jest przewijane zostało zapisane w stylu CS_OWNDC lub CS_CLASSDC, ten parametr używa jednostek logicznych, zamiast urządzenia jednostek. Ten parametr musi być wartością ujemną aby przewijać zawartość okna w górę.

lpRect

Wskaźnik do RECT Struktura określająca część obszaru klienta, aby być przewijane. Jeśli ten parametr ma wartość NULL, całego obszaru klienta jest przewijane.

lpClipRect

Wskaźnik do struktury RECT zawiera współrzędne prostokąta przycinania. Dotyczy tylko urządzenia bitów wewnątrz prostokąta przycinania. Bity przewijane z zewnątrz prostokąta wewnątrz są malowane; bity przewijane wewnątrz prostokąta na zewnątrz nie są malowane.

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

Jeśli kursor znajduje się w oknie są przewijane, ScrollWindow automatycznie ukrywa daszek aby zapobiec są usuwane i następnie przywraca daszek po zakończeniu pracy przewijania. Odpowiednio dostosować pozycję karetki.

Obszar nieobjętą ScrollWindow nie jest odowieżany, ale są łączone w oknie aktualizacji regionu. Aplikacja ostatecznie odbiera wiadomość WM_PAINT, powiadamiając go, że region musi być odowieżany. Do odświeżenia obszaru odkryte w tym samym czasie, którego przewijanie w działaniu, wywołania funkcji UpdateWindow natychmiast po wywołaniu ScrollWindow.

Jeśli parametr lpRect ma wartość NULL, pozycje żadnych okien podrzędnych w oknie jest rekompensowana kwoty określonej przez parametry XAmount i YAmount ; Nieprawidłowe obszary (niemalowanej) w oknie również są przesunięte. ScrollWindow jest szybciej, gdy lpRect ma wartość NULL.

Jeśli lpRect nie ma wartości NULL, pozycje okien podrzędnych nie są zmieniane i nieprawidłowe obszary okna nie są zrównoważone. Aby uniemożliwić aktualizację problemów, gdy lpRect nie ma wartości NULL, wywołanie UpdateWindow do odświeżenia okna przed wywołaniem metody ScrollWindow.

Skrócone informacje

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

Zobacz też

Przewiń paski omówienie, funkcje paska przewijania, RECT, ScrollDC, ScrollWindowEx, UpdateWindow

Index