Messaggio _ HSCROLL WM

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

Una finestra riceve questo messaggio tramite la relativa funzione WindowProc.

WM_HSCROLL

    WPARAM wParam
    LPARAM lParam; 

Parametri

wParam

HiWORD specifica la posizione corrente della casella di scorrimento se il valore LOWORD è SB THUMBPOSITION o _ SB THUMBTRACK. In caso contrario, questa _ parola non viene usata.

La parola chiave LOWORD specifica un valore della barra di scorrimento che indica la richiesta di scorrimento dell'utente. Questa parola può essere uno dei valori seguenti.

Valore Significato
SB _ ENDSCROLL
Termina lo scorrimento.
SB _ A SINISTRA
Scorre verso l'alto a sinistra.
SB _ RIGHT
Scorre verso l'angolo inferiore destro.
SB _ LINELEFT
Scorre verso sinistra di un'unità.
SB _ LINERIGHT
Scorre verso destra di un'unità.
SB _ PAGELEFT
Scorre verso sinistra della larghezza della finestra.
SB _ PAGERIGHT
Scorre verso destra in base alla larghezza della finestra.
SB _ THUMBPOSITION
L'utente ha trascinato la casella di scorrimento (thumb) e 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 fino a quando l'utente non rilascia il pulsante del mouse. HiWORD indica la posizione in cui è stata trascinata la casella di scorrimento.

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.

Commenti

Il codice della richiesta THUMBTRACK SB 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 _ HSCROLL contiene solo 16 bit di dati sulla posizione della casella di scorrimento. Di conseguenza, le applicazioni che si basano esclusivamente su WM _ HSCROLL (e WM _ VSCROLL) per i dati sulla posizione di scorrimento hanno un valore pratico di posizione massima di 65.535.

Tuttavia, poiché le funzioni SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPose GetScrollRange supportano i dati di 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 Solo [ app desktop di Vista]
Server minimo supportato
Windows Solo app desktop server 2003 []
Intestazione
Winuser.h (includere Windows.h)

Vedi anche

Riferimento

GetScrollInfo

GetScrollPos

GetScrollRange

SetScrollInfo

SetScrollPos

SetScrollRange

WM _ HSCROLL (trackbar)

WM _ VSCROLL