SetScrollRange

La funzione SetScrollRange imposta i valori minimo e massimo di posizione per la barra di scorrimento specificato.

La funzione SetScrollRange è disponibile per compatibilità con le versioni precedenti. Nuove applicazioni dovrebbero utilizzare la funzione SetScrollInfo.

 (BOOL SetScrollRange HWND  hWnd, / / handle di finestra con barra di scorrimentointnBar, / / scroll bar bandieraintnMinPos, / / minimo scorrimento posizioneintnMaxPos, / / massima posizione a scorrimentoBOOLbRedraw / / ridisegnare la bandiera);
 

Parametri

hWnd
Handle per un controllo barra di scorrimento o una finestra con una barra di scorrimento standard, a seconda del valore del parametro nBar.
nBar
Specifica la barra di scorrimento da impostare. Questo parametro può essere uno dei seguenti valori:
Valore Significato
SB_CTL Imposta l'intervallo di un controllo barra di scorrimento. Il parametro hWnd deve essere l'handle per il controllo barra di scorrimento.
SB_HORZ Imposta l'intervallo della barra di scorrimento orizzontale standard di una finestra.
SB_VERT Imposta l'intervallo della barra di scorrimento verticale standard di una finestra.

nMinPos
Specifica il posizione di scorrimento minimo.
nMaxPos
Specifica il posizione di scorrimento massimo.
bRedraw
Specifica se la barra di scorrimento deve essere ridisegnata per riflettere la modifica. Se questo parametro è TRUE, la barra di scorrimento viene ridisegnata. Se è FALSE, la barra di scorrimento non viene ridisegnata.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

È possibile utilizzare SetScrollRange per nascondere la barra di scorrimento da impostazione nMinPos e nMaxPos allo stesso valore. Un'applicazione non deve chiamare la funzione SetScrollRange per nascondere una barra di scorrimento durante l'elaborazione di un messaggio di barra di scorrimento. Nuove applicazioni dovrebbero utilizzare la funzione ShowScrollBar per nascondere la barra di scorrimento.

Se la chiamata a SetScrollRange segue immediatamente una chiamata alla funzione SetScrollPos , il parametro bRedraw in SetScrollPos deve essere zero per impedire che la barra di scorrimento viene disegnato due volte.

L'intervallo predefinito per una barra di scorrimento standard è 0 e 100. L'intervallo predefinito per un controllo barra di scorrimento è vuoto (sia nMinPos che nMaxPos i valori dei parametri sono zero). La differenza tra i valori specificati dai parametri nMinPos e nMaxPos non deve essere maggiore del valore di MAXLONG.

Perché i messaggi che indicano la posizione della barra di scorrimento, WM_HSCROLL e WM_VSCROLL, sono limitati a 16 bit di dati di posizione, le applicazioni che si basano unicamente su quei messaggi per i dati di posizione hanno un valore massimo pratico di 65.535 per parametro nMaxPos della funzione SetScrollRange.

Tuttavia, poiché il SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPose GetScrollRange funzioni supportano dati di posizione barra di scorrimento a 32-bit, c'è un modo per aggirare la barriera di 16 bit degli i WM_VSCROLL messaggi WM_HSCROLL e. Per una descrizione della tecnica, vedere GetScrollInfo.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 2.0 o successiva.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.

Vedi anche

Panoramica di barre di scorrimento, le funzioni della barra di scorrimento, GetScrollInfo, GetScrollPos, GetScrollRange, SetScrollInfo, SetScrollPos, ShowScrollBar

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

Index