SetScrollPos

La funzione SetScrollPos imposta la posizione della casella di scorrimento (pollice) nella barra di scorrimento specificato e, se richiesto, ridisegna la barra di scorrimento per riflettere la nuova posizione della casella di scorrimento.

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

int (SetScrollPos HWND  hWnd, / / handle di finestra con barra di scorrimentointnBar, / / scroll bar bandieraintNPO, / / nuova posizione della casella di 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 la posizione della casella di scorrimento in un controllo barra di scorrimento. Il parametro hWnd deve essere l'handle per il controllo barra di scorrimento.
SB_HORZ	Imposta la posizione della casella di scorrimento nella barra di scorrimento orizzontale standard di una finestra.
SB_VERT	Imposta la posizione della casella di scorrimento nella barra di scorrimento verticale standard di una finestra.

nPO

Consente di specificare la nuova posizione della casella di scorrimento. La posizione deve essere all'interno della gamma di scorrimento. Per ulteriori informazioni sulla gamma di scorrimento, vedere la funzione SetScrollRange.

bRedraw

Specifica se la barra di scorrimento viene ridisegnata per riflettere la nuova posizione di casella di scorrimento. 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 è la precedente posizione della casella di scorrimento.

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

Osservazioni

Se la barra di scorrimento viene ridisegnata da una chiamata successiva a un'altra funzione, impostando il parametro bRedraw su FALSE è utile.

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 NPO della funzione SetScrollPos.

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, SetScrollRange

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

Index