Funzione GetScrollRange (winuser.h)

Articolo
03/15/2023

La funzione GetScrollRange recupera le posizioni di scorrimento minime e massime correnti (pollice) per la barra di scorrimento specificata.

Nota La funzione GetScrollRange viene fornita solo per la compatibilità. Le nuove applicazioni devono usare la funzione GetScrollInfo .

Sintassi

BOOL GetScrollRange(
  [in]  HWND  hWnd,
  [in]  int   nBar,
  [out] LPINT lpMinPos,
  [out] LPINT lpMaxPos
);

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 cui vengono recuperate le posizioni. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
SB_CTL	Recupera le posizioni di un controllo barra di scorrimento. Il parametro hWnd deve essere l'handle per il controllo barra di scorrimento.
SB_HORZ	Recupera le posizioni della barra di scorrimento orizzontale standard della finestra.
SB_VERT	Recupera le posizioni della barra di scorrimento verticale standard della finestra.

[out] lpMinPos

Tipo: LPINT

Puntatore alla variabile integer che riceve la posizione minima.

[out] lpMaxPos

Tipo: LPINT

Puntatore alla variabile integer che riceve la posizione massima.

Valore restituito

Tipo: BOOL

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

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

Commenti

Se la finestra specificata non dispone di barre di scorrimento standard o non è un controllo barra di scorrimento, la funzione GetScrollRange copia zero nei parametri lpMinPos e lpMaxPos.

L'intervallo predefinito per una barra di scorrimento standard è compreso tra 0 e 100. L'intervallo predefinito per un controllo barra di scorrimento è vuoto (entrambi i valori sono zero).

I messaggi che indicano la posizione della barra di scorrimento, WM_HSCROLL e WM_VSCROLL, sono limitati a 16 bit di dati di posizione. Tuttavia, poiché SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPos e GetScrollRange supportano i dati di posizione della barra di scorrimento a 32 bit, è possibile aggirare la barriera a 16 bit dei messaggi WM_HSCROLL e WM_VSCROLL. Per una descrizione della tecnica, vedere 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_GETRANGE alla finestra per ottenere informazioni sulla barra di scorrimento. Ciò consente a GetScrollRange di funzionare su un controllo personalizzato che simula una barra di scorrimento. Se la finestra non gestisce il messaggio di SBM_GETRANGE , la funzione GetScrollRange 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