Funzione SetScrollInfo (winuser.h)
La funzione SetScrollInfo imposta i parametri di una barra di scorrimento, tra cui le posizioni di scorrimento minime e massime, le dimensioni della pagina e la posizione della casella di scorrimento (pollice). La funzione ridisegna anche la barra di scorrimento, se richiesta.
Sintassi
int SetScrollInfo(
[in] HWND hwnd,
[in] int nBar,
[in] LPCSCROLLINFO lpsi,
[in] BOOL redraw
);
Parametri
[in] hwnd
Tipo: HWND
Gestire un controllo barra di scorrimento o una finestra con una barra di scorrimento standard, a seconda del valore del parametro fnBar .
[in] nBar
Tipo: int
Specifica il tipo di barra di scorrimento per cui impostare i parametri. Questo parametro può avere uno dei valori seguenti.
[in] lpsi
Tipo: LPCSCROLLINFO
Puntatore a una struttura SCROLLINFO . Prima di chiamare SetScrollInfo, impostare il membro cbSize della struttura su sizeof(SCROLLINFO), impostare il membro fMask per indicare i parametri da impostare e specificare i nuovi valori dei parametri nei membri appropriati.
Il membro fMask può essere uno o più dei valori seguenti.
| Valore | Significato |
|---|---|
|
Disabilita la barra di scorrimento anziché rimuoverla, se il nuovo parametro della barra di scorrimento rende la barra di scorrimento non necessaria. |
|
Imposta la pagina di scorrimento sul valore specificato nel membro nPage della struttura SCROLLINFO a cui punta lpsi. |
|
Imposta la posizione di scorrimento sul valore specificato nel membro nPos della struttura SCROLLINFO a cui punta lpsi. |
|
Imposta l'intervallo di scorrimento sul valore specificato nei membri nMin e nMax della struttura SCROLLINFO a cui punta lpsi. |
[in] redraw
Tipo: BOOL
Specifica se la barra di scorrimento viene ridisegnata per riflettere le modifiche apportate alla barra di scorrimento. Se questo parametro è TRUE, la barra di scorrimento viene ridisegnata, in caso contrario, non viene ridisegnata.
Valore restituito
Tipo: int
Il valore restituito è la posizione corrente della casella di scorrimento.
Commenti
La funzione SetScrollInfo esegue il controllo dell'intervallo sui valori specificati dai membri nPage e nPos della struttura SCROLLINFO . Il membro nPage deve specificare un valore compreso tra 0 e nMax - nMin +1. Il membro nPos deve specificare un valore compreso tra nMin e nMax - max( nPage– 1, 0). Se entrambi i valori superano l'intervallo, la funzione lo imposta su un valore che si trova all'interno dell'intervallo.
Se il parametro fnBar è SB_CTL e la finestra specificata dal parametro hwnd non è un controllo barra di scorrimento di sistema, il sistema invia il messaggio SBM_SETSCROLLINFO alla finestra per impostare le informazioni sulla barra di scorrimento (il sistema può ottimizzare il messaggio per SBM_SETPOS o SBM_SETRANGE se la richiesta è esclusivamente per la posizione o l'intervallo). Ciò consente a SetScrollInfo di funzionare su un controllo personalizzato che simula una barra di scorrimento. Se la finestra non gestisce SBM_SETSCROLLINFO (o il messaggio ottimizzato SBM_SETPOS o SBM_SETRANGE messaggio), la funzione SetScrollInfo ha esito negativo.
Per un esempio, vedere Scorrimento del testo con il messaggio WM_PAINT.
Requisiti
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winuser.h (include Windows.h) |
| Libreria | User32.lib |
| DLL | User32.dll |
| Set di API | ext-ms-win-ntuser-misc-l1-2-0 (introdotto in Windows 8.1) |
Vedi anche
Riferimento