WM_VSCROLL messaggio

  • Articolo

Il messaggio WM_VSCROLL viene inviato a una finestra quando si verifica un evento di scorrimento nella barra di scorrimento verticale standard della finestra. Questo messaggio viene inviato anche al proprietario di un controllo barra di scorrimento verticale quando si verifica un evento di scorrimento nel controllo .

Una finestra riceve questo messaggio tramite la relativa funzione WindowProc.

WM_VSCROLL

    WPARAM wParam
    LPARAM lParam;

Parametri

wParam

HIWORD specifica la posizione corrente della casella di scorrimento se LOWORD è SB_THUMBPOSITION o SB_THUMBTRACK; in caso contrario, questa parola non viene utilizzata.

LOWORD specifica un valore della barra di scorrimento che indica la richiesta di scorrimento dell'utente. Questo parametro può avere uno dei valori seguenti.

Valore Significato
SB_BOTTOM
 Scorre verso il basso a destra.
SB_ENDSCROLL
 Termina lo scorrimento.
SB_LINEDOWN
 Scorre una riga verso il basso.
SB_LINEUP
 Scorre una riga verso l'alto.
SB_PAGEDOWN
 Scorre una pagina verso il basso.
SB_PAGEUP
 Scorre una pagina verso l'alto.
SB_THUMBPOSITION
 L'utente ha trascinato la casella di scorrimento (pollice) e ha rilasciato il pulsante del mouse. HIWORD indica la posizione della casella di scorrimento alla fine dell'operazione di trascinamento.
SB_THUMBTRACK
 L'utente sta trascinando la casella di scorrimento. Questo messaggio viene inviato ripetutamente finché l'utente non rilascia il pulsante del mouse. HIWORD indica la posizione in cui è stata trascinata la casella di scorrimento.
SB_TOP
 Scorre verso l'alto a sinistra.

lParam

Se il messaggio viene inviato da un controllo barra di scorrimento, questo parametro è l'handle per il controllo barra di scorrimento. Se il messaggio viene inviato da una barra di scorrimento standard, questo parametro è NULL.

Valore restituito

Se un'applicazione elabora questo messaggio, deve restituire zero.

Osservazioni:

Il codice di richiesta SB_THUMBTRACK viene in genere usato dalle applicazioni che forniscono commenti e suggerimenti quando l'utente trascina la casella di scorrimento.

Se un'applicazione scorre il contenuto della finestra, deve anche reimpostare la posizione della casella di scorrimento usando la funzione SetScrollPos.

Si noti che il messaggio WM_VSCROLL contiene solo 16 bit di dati di posizione casella di scorrimento. Pertanto, le applicazioni che si basano esclusivamente su WM_VSCROLL (e WM_HSCROLL) per i dati di posizione di scorrimento hanno un valore di posizione massimo pratico pari a 65.535.

Tuttavia, poiché le funzioni SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPos e GetScrollRange supportano i dati sulla posizione della barra di scorrimento a 32 bit, esiste un modo per aggirare la barriera a 16 bit dei messaggi WM_HSCROLL e WM_VSCROLL. Per una descrizione della tecnica, vedere GetScrollInfo .

Requisiti

Requisito Valore
Client minimo supportato
 Windows Vista [solo app desktop]
Server minimo supportato
 Windows Server 2003 [solo app desktop]
Intestazione
Winuser.h (include Windows.h)

Vedi anche

Riferimento

GetScrollInfo

GetScrollPos

GetScrollRange

SetScrollInfo

SetScrollPos

SetScrollRange

WM_HSCROLL

WM_VSCROLL (barra di avanzamento)