ScrollWindowEx

La funzione ScrollWindowEx scorre il contenuto dell'area client della finestra specificata.

int (ScrollWindowEx HWND  hWnd, / / handle alla finestra per scorrereint dx, / / quantità di orizzontale a scorrimentoint dy, / / quantità di vertical scrollingCONST RECT* prcScroll,  / / indirizzo della struttura con il rettangolo di scorrimentoCONST RECT* prcClip,  / / indirizzo della struttura con il rettangolo di clipHRGNhrgnUpdate, / / handle per aggiornare la regioneLPRECTprcUpdate, / / indirizzo della struttura per aggiornamento rectangleUINTbandiere / / bandiere a scorrimento);
 

Parametri

hWnd

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

dx

Specifica la quantità, in unità periferica, di scorrimento orizzontale. Questo parametro deve essere un valore negativo per scorrere verso sinistra.

dy

Specifica la quantità, in unità periferica, di scorrimento verticale. Questo parametro deve essere un valore negativo per scorrere verso l'alto.

prcScroll

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

prcClip

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.

hrgnUpdate

Gestire la regione che è modificata per contenere la regione invalidata da lo scorrimento. Questo parametro può essere NULL.

prcUpdate

Puntatore alla struttura RECT ricevendo i limiti del rettangolo invalidate da lo scorrimento. Questo parametro può essere NULL.

bandiere

Specifica i flag che controllano lo scorrimento. Questo parametro può essere uno dei seguenti valori:

Valore	Significato
SW_ERASE	Cancella la regione appena invalidata inviando un messaggio WM_ERASEBKGND alla finestra quando specificato con il flag SW_INVALIDATE.
SW_INVALIDATE	Invalida l'area identificata dal parametro hrgnUpdate dopo lo scorrimento.
SW_SCROLLCHILDREN	Scorre tutte le finestre del bambino che intersecano il rettangolo a cui puntato il parametro prcScroll . Le finestre figlio vengono fatti scorrere dal numero di pixel specificato dai parametri dx e dy . Il sistema invia un messaggio a WM_MOVE a tutte le finestre del bambino che intersecano il rettangolo di prcScroll , anche se essi non si muovono.
SW_SMOOTHSCROLL	Windows NT 5.0 e versioni successive: Pergamene utilizzando lo scorrimento liscio. Utilizzare la parte HIWORD del parametro flags per indicare quanto tempo dovrebbe prendere l'operazione di scorrimento.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito è SIMPLEREGION (regione rettangolare invalidato), COMPLEXREGION (regione invalidato non rettangolari; sovrapposizione rettangoli) o NULLREGION (nessuna regione invalidato).

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

Osservazioni

Se non viene specificato il flag SW_INVALIDATE e SW_ERASE, ScrollWindowEx non invalida l'area che si scorre da. Se uno di questi flag è impostato, ScrollWindowEx invalida quest'area. L'area non viene aggiornato fino a quando l'applicazione chiama il UpdateWindow funzione, chiamate i RedrawWindow funzione (specificando il flag RDW_UPDATENOW o RDW_ERASENOW), o recupera il messaggio WM_PAINT dalla coda dell'applicazione.

Se la finestra ha lo stile WS_CLIPCHILDREN, le aree restituite specificate da hrgnUpdate e prcUpdate rappresentano l'area totale della finestra scorrimento che deve essere aggiornata, compresi eventuali aree in finestre figlio che devono essere aggiornate.

Se viene specificato il flag SW_SCROLLCHILDREN, il sistema non correttamente aggiornare lo schermo se si scorre la parte di una finestra figlia. La parte della finestra figlio scorrimento che si trova all'esterno del rettangolo di origine non viene cancellata e non viene ridisegnata correttamente nella sua nuova destinazione. Per spostare le finestre figlio che non si trovano completamente all'interno del rettangolo specificato da prcScroll, utilizzare la funzione Error_invalid_dwp_handle . Il cursore viene riposizionato se è impostato il flag SW_SCROLLCHILDREN e del punto di inserimento rettangolo con il rettangolo di scorrimento.

Tutte le coordinate di input e di output (per prcScroll, prcClip, prcUpdatee hrgnUpdate) sono determinate come coordinate client, indipendentemente dal fatto se la finestra ha lo stile di classe CS_OWNDC o CS_CLASSDC. Utilizzare le funzioni LPtoDP e DPtoLP per convertire le coordinate logiche e se necessario.

Windows CE: Il parametro flags non supporta SW_SCROLLCHILDREN.

Solo uno dei parametri dx e dy può essere diverso da zero.

Descrizione

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

Vedi anche

Scorre bar panoramica, funzioni di barra di scorrimento, Error_invalid_dwp_handle, DPtoLP, LPtoDP, RECT, RedrawWindow, UpdateWindow

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

Index