GetScrollInfo

La funzione GetScrollInfo recupera i parametri di un rotolo bar, tra cui il minimo e il massimo scorrimento posizioni, la dimensione della pagina e la posizione della casella di scorrimento (pollice).

(BOOL GetScrollInfo HWND  hwnd, / / handle di finestra con barra di scorrimentointfnBar, / / scroll bar bandieraLPSCROLLINFOLPSI / / puntatore alla struttura per i parametri di scorrimento);
 

Parametri

hwnd
Handle per un controllo barra di scorrimento o una finestra con una barra di scorrimento standard, a seconda del valore del parametro fnBar.
fnBar
Specifica il tipo di barra di scorrimento per il quale recuperare i parametri. Questo parametro può essere uno dei seguenti valori:
Valore Significato
SB_CTL Recupera i parametri per un controllo barra di scorrimento. Il parametro hwnd deve essere l'handle per il controllo barra di scorrimento.
SB_HORZ Recupera i parametri per la barra di scorrimento orizzontale standard di dato della finestra.
SB_VERT Recupera i parametri per la barra di scorrimento verticale standard di dato della finestra.

lpsi
Puntatore a una struttura SCROLLINFO . Prima di chiamare GetScrollInfo, impostare il cbSize membro della struttura di sizeof(SCROLLINFO) e il membro fMask per specificare i parametri di barra di scorrimento per recuperare. Prima di tornare, la funzione copia i parametri specificati i membri appropriati della struttura.

Il membro fMask può essere una combinazione dei seguenti valori:
Valore Significato
SIF_PAGE Copie nella pagina di scorrimento per il membro nPage della struttura SCROLLINFO puntato da lpsi.
SIF_POS Copie la posizione di scorrimento al membro della struttura SCROLLINFO NPO puntato da lpsi.
SIF_RANGE La gamma di scorrimento vengono copiati i nMin e nMax membri della struttura SCROLLINFO puntano da lpsi.
SIF_TRACKPOS Copie la casella di scorrimento attuale posizione di rilevamento al membro nTrackPos della struttura SCROLLINFO puntato da lpsi.

Valori restituiti

Se la funzione recuperati tutti i valori, il valore restituito è diverso da zero.

Se la funzione non recupera tutti i valori, il valore restituito è zero. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

La funzione GetScrollInfo consente alle applicazioni di utilizzare posizioni di scorrimento a 32-bit. Anche se i messaggi che indicano la posizione della barra di scorrimento, WM_HSCROLL e WM_VSCROLL, forniscono solo 16 bit di dati di posizione, le funzioni SetScrollInfo e GetScrollInfo forniscono a 32 bit di dati di posizione barra di scorrimento. Così, un'applicazione può chiamare GetScrollInfo durante l'elaborazione di messaggi WM_HSCROLL o WM_VSCROLL per ottenere i dati relativi alla posizione barra di scorrimento a 32-bit.

Per ottenere la posizione a 32-bit della casella di scorrimento (pollice) durante una notifica di SB_THUMBTRACK in un messaggio WM_HSCROLL o WM_VSCROLL, chiamare GetScrollInfo con il valore SIF_TRACKPOS nel membro della struttura SCROLLINFO fMask . La funzione restituisce la posizione di rilevamento della casella di scorrimento nel membro nTrackPos della struttura SCROLLINFO . Questo consente di ottenere la posizione della casella di scorrimento, quando l'utente si muove. Nell'esempio di codice seguente viene illustrata la tecnica.

Se SCROLLINFO;
caso WM_HSCROLL:
    {Switch(LOWORD(WPARAM))
        caso SB_THUMBTRACK:
          / / Initialize struttura SCROLLINFO
 
            ZeroMemory (amp; si, sizeof(SCROLLINFO));
            si.cbSize = sizeof(SCROLLINFO);
            si.fMask = SIF_TRACKPOS;
 
          / / Call GetScrollInfo per ottenere corrente tracking / / posizione in si.nTrackPos
 
            if (!.GetScrollInfo(hwnd, SB_HORZ, &si))
                restituire 1; / / GetScrollInfo fallito
            pausa;
        .
        .
        .
    } 

Descrizione

nbsp; Windows &NT: richiede 3,51 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, SCROLLINFO, SetScrollInfo, WM_HSCROLL, WM_VSCROLL

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

Index