Funzione GetScrollPos (winuser.h)

Articolo
08/27/2023

La funzione GetScrollPos recupera la posizione corrente della casella di scorrimento (pollice) nella barra di scorrimento specificata. La posizione corrente è un valore relativo che dipende dall'intervallo di scorrimento corrente. Ad esempio, se l'intervallo di scorrimento è compreso tra 0 e 100 e la casella di scorrimento si trova al centro della barra, la posizione corrente è 50.

Nota La funzione GetScrollPos viene fornita per la compatibilità con le versioni precedenti. Le nuove applicazioni devono usare la funzione GetScrollInfo .

Sintassi

int GetScrollPos(
  [in] HWND hWnd,
  [in] int  nBar
);

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 nBar .

[in] nBar

Tipo: int

Specifica la barra di scorrimento da esaminare. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
SB_CTL	Recupera 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	Recupera la posizione della casella di scorrimento nella barra di scorrimento orizzontale standard di una finestra.
SB_VERT	Recupera la posizione della casella di scorrimento nella barra di scorrimento verticale standard di una finestra.

Valore restituito

Tipo: int

Se la funzione ha esito positivo, il valore restituito è la posizione corrente della casella di scorrimento.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione GetScrollPos consente alle applicazioni di usare posizioni di scorrimento a 32 bit. Anche se 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 funzioni SetScrollPos, SetScrollRange, GetScrollPos e GetScrollRange supportano i dati di posizione della barra di scorrimento a 32 bit. Pertanto, un'applicazione può chiamare GetScrollPos durante l'elaborazione dei messaggi WM_HSCROLL o WM_VSCROLL per ottenere i dati di posizione della barra di scorrimento a 32 bit.

Per ottenere la posizione a 32 bit della casella di scorrimento (pollice) durante un codice di richiesta SB_THUMBTRACK in un messaggio WM_HSCROLL o WM_VSCROLL , usare la funzione GetScrollInfo .

Se il parametro nBar è SB_CTL e la finestra specificata dal parametro hWnd non è un controllo barra di scorrimento di sistema, il sistema invia il messaggio SBM_GETPOS alla finestra per ottenere informazioni sulla barra di scorrimento. Ciò consente a GetScrollPos di operare su un controllo personalizzato che simula una barra di scorrimento. Se la finestra non gestisce il messaggio di SBM_GETPOS , la funzione GetScrollPos ha esito negativo.

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)