messaggio SBM_GETSCROLLINFO

Il messaggio SBM_GETSCROLLINFO viene inviato per recuperare i parametri di una barra di scorrimento.

Le applicazioni non devono inviare direttamente questo messaggio. Devono invece usare la funzione GetScrollInfo . Una finestra riceve questo messaggio tramite la relativa funzione WindowProc . Le applicazioni che implementano un controllo barra di scorrimento personalizzato devono rispondere a questi messaggi per il corretto funzionamento della funzione GetScrollInfo .

Parametri

wParam

Questo parametro non viene usato.

lParam

Puntatore a una struttura SCROLLINFO . Prima di chiamare GetScrollInfo, impostare il membro cbSize della struttura su sizeof(SCROLLINFO) e impostare il membro fMask per specificare i parametri della barra di scorrimento da recuperare. Prima di restituire, il messaggio copia i parametri specificati nei membri appropriati della struttura.

Il membro fMask può essere uno o più dei valori seguenti.

Valore	Significato
SIF_ALL	Combinazione di SIF_PAGE, SIF_POS, SIF_RANGE e SIF_TRACKPOS.
SIF_PAGE	Copia la pagina di scorrimento nel membro nPage.
SIF_POS	Copia la posizione di scorrimento nel membro nPos.
SIF_RANGE	Copia l'intervallo di scorrimento nei membri nMin e nMax.
SIF_TRACKPOS	Copia la posizione di rilevamento della casella di scorrimento corrente nel membro nTrackPos.

Valore restituito

Se il messaggio ha recuperato i valori, il valore restituito è TRUE; in caso contrario, è FALSE.

Commenti

I messaggi che indicano la posizione della barra di scorrimento, WM_HSCROLL e WM_VSCROLL, forniscono solo 16 bit di dati di posizione. Tuttavia, la struttura SCROLLINFO usata da SBM_GETSCROLLINFO, SBM_SETSCROLLINFO, GetScrollInfo e SetScrollInfo fornisce 32 bit di dati di posizione della barra di scorrimento. È possibile usare questi messaggi e funzioni durante l'elaborazione dei messaggi WM_HSCROLL o WM_VSCROLL per ottenere i dati della barra di scorrimento a 32 bit.

Per ottenere la posizione a 32 bit della casella di scorrimento (pollice) durante un codice di richiesta SB_THUMBTRACK in un messaggioWM_HSCROLL o WM_VSCROLL, inviare SBM_GETSCROLLINFO con il valore SIF_TRACKPOS nel membro fMask della struttura SCROLLINFO. Il messaggio restituisce la posizione di rilevamento della casella di scorrimento nel membro nTrackPos della struttura SCROLLINFO . Ciò consente di ottenere la posizione della casella di scorrimento mentre l'utente lo sposta. In alternativa, è possibile usare la funzione GetScrollInfo per ottenere le stesse informazioni.

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

SBM_SETSCROLLINFO

SCROLLINFO

SetScrollInfo