WM_HSCROLL messaggio

  • Articolo

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 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. Questa parola può essere uno dei valori seguenti.

Valore Significato
SB_ENDSCROLL
 Termina lo scorrimento.
SB_LEFT
 Scorre verso l'alto a sinistra.
SB_RIGHT
 Scorre verso il basso a destra.
SB_LINELEFT
 Scorre verso sinistra di un'unità.
SB_LINERIGHT
 Scorre verso destra di un'unità.
SB_PAGELEFT
 Scorre verso sinistra in base alla larghezza della finestra.
SB_PAGERIGHT
 Scorre verso destra in base alla larghezza della finestra.
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.

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_HSCROLL contiene solo 16 bit di dati di posizione casella di scorrimento. Pertanto, le applicazioni che si basano esclusivamente su WM_HSCROLL (e WM_VSCROLL) 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 (barra di avanzamento)

WM_VSCROLL