ScrollWindow

La funzione ScrollWindow scorre il contenuto dell'area client della finestra specificata. La funzione ScrollWindow non esiste per compatibilità con le versioni precedenti. Nuove applicazioni dovrebbero utilizzare la funzione ScrollWindowEx.

(BOOL ScrollWindow HWND  hWnd, / / handle alla finestra per scorrereintXAmount, / / quantità di orizzontale a scorrimentointYAmount, / / quantità di vertical scrolling CONST RECT* lpRect,  / / indirizzo della struttura con il rettangolo di scorrimentoCONST RECT* lpClipRect / / indirizzo della struttura con il rettangolo di clip);
 

Parametri

hWnd

Gestire alla finestra dove è possibile scorrere l'area client.

XAmount

Specifica la quantità, in unità periferica, di scorrimento orizzontale. Se la finestra sta scorse ha lo stile CS_OWNDC o CS_CLASSDC, questo parametro utilizza unità logiche piuttosto che unità periferica. Questo parametro deve essere un valore negativo per scorrere il contenuto della finestra a sinistra.

YAmount

Specifica la quantità, in unità periferica, di scorrimento verticale. Se la finestra sta scorse ha lo stile CS_OWNDC o CS_CLASSDC, questo parametro utilizza unità logiche piuttosto che unità periferica. Questo parametro deve essere un valore negativo per scorrere il contenuto della finestra.

lpRect

Puntatore ai struttura RECT specifica la parte dell'area client a scorrere. Se questo parametro è NULL, si scorre l'intera area client.

lpClipRect

Puntatore alla struttura RECT contenente le coordinate del rettangolo di ritaglio. Sono interessati solo pezzi di dispositivo all'interno del rettangolo di ritaglio. Bit che scorre dall'esterno del rettangolo all'interno sono verniciati; bit scorre dall'interno del rettangolo verso l'esterno non sono dipinte.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

Se il punto di inserimento nella finestra sta durante lo scorrimento, ScrollWindow nasconde automaticamente il punto di inserimento per impedire di essere cancellato e quindi ripristina il punto di inserimento dopo lo scorrimento è finito. La posizione del punto di inserimento viene regolata di conseguenza.

L'area scoperto dalla ScrollWindow non è ridipinta, ma si è combinato in regione di aggiornamento della finestra. L'applicazione alla fine riceve un messaggio di WM_PAINT si notifica che la regione deve essere ridisegnata. Di ridipingere la zona scoperta al tempo stesso che lo scorrimento è in azione, chiamare la funzione UpdateWindow subito dopo ScrollWindow.

Se il parametro lpRect è NULL, le posizioni di tutte le finestre del bambino nella finestra sono compensate dall'importo specificato dai parametri XAmount e YAmount ; aree (non verniciate) non validi nella finestra anche sono compensati. ScrollWindow è più veloce quando lpRect è NULL.

Se lpRect non è NULL, non vengono modificate le posizioni delle finestre figlio e aree non validi nella finestra non sono compensati. Per evitare che l'aggiornamento problemi quando lpRect non è NULL, chiamare UpdateWindow di ridipingere la finestra prima di chiamare ScrollWindow.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Non supportato.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.

Vedi anche

Scorre bar panoramica, le funzioni della barra di scorrimento, RECT, ScrollDC, ScrollWindowEx, UpdateWindow

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index