Condividi tramite


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.

Valore Significato
SB_CTL
Imposta i parametri di un controllo barra di scorrimento. Il parametro hwnd deve essere l'handle per il controllo barra di scorrimento.
SB_HORZ
Imposta i parametri della barra di scorrimento orizzontale standard della finestra.
SB_VERT
Imposta i parametri della barra di scorrimento verticale standard della finestra.

[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
SIF_DISABLENOSCROLL
Disabilita la barra di scorrimento anziché rimuoverla, se il nuovo parametro della barra di scorrimento rende la barra di scorrimento non necessaria.
SIF_PAGE
Imposta la pagina di scorrimento sul valore specificato nel membro nPage della struttura SCROLLINFO a cui punta lpsi.
SIF_POS
Imposta la posizione di scorrimento sul valore specificato nel membro nPos della struttura SCROLLINFO a cui punta lpsi.
SIF_RANGE
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

GetScrollInfo

Riferimento

SCROLLINFO