ScrollBar

Articolo
02/21/2024

Questa sezione contiene informazioni sugli elementi di programmazione usati con le barre di scorrimento. Una finestra può visualizzare un oggetto dati, ad esempio un documento o una bitmap, più grande dell'area client della finestra. Se fornito con una barra di scorrimento, l'utente può scorrere un oggetto dati nell'area client per visualizzare le parti dell'oggetto che si estendono oltre i bordi della finestra.

Panoramiche

Argomento	Contenuto
Informazioni sulle barre di scorrimento	Una barra di scorrimento è costituita da un albero ombreggiato con un pulsante freccia a ogni estremità e una casella di scorrimento (talvolta detta pollice) tra i pulsanti freccia.
Uso delle barre di scorrimento	Quando si crea una finestra sovrapposta, popup o figlio, è possibile aggiungere barre di scorrimento standard usando la funzione CreateWindowEx e specificando WS_HSCROLL, WS_VSCROLL o entrambi gli stili.

Funzioni

Argomento	Contenuto
EnableScrollBar	La funzione EnableScrollBar abilita o disabilita una o entrambe le frecce della barra di scorrimento.
GetScrollBarInfo	La funzione GetScrollBarInfo recupera informazioni sulla barra di scorrimento specificata.
GetScrollInfo	La funzione GetScrollInfo recupera i parametri di una barra di scorrimento, incluse le posizioni di scorrimento minime e massime, le dimensioni della pagina e la posizione della casella di scorrimento (thumb).
GetScrollPos	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.
GetScrollRange	La funzione GetScrollRange recupera le posizioni correnti della casella di scorrimento minima e massima (pollice) per la barra di scorrimento specificata. Nota: la funzione GetScrollRange è disponibile solo per la compatibilità. Le nuove applicazioni devono usare la funzione GetScrollInfo.
ScrollDC	La funzione ScrollDC scorre un rettangolo di bit orizzontalmente e verticalmente.
Scrollwindow	La funzione ScrollWindow scorre il contenuto dell'area client della finestra specificata. Nota: la funzione ScrollWindow è disponibile per la compatibilità con le versioni precedenti. Le nuove applicazioni devono usare la funzione ScrollWindowEx.
ScrollWindowEx	La funzione ScrollWindowEx scorre il contenuto dell'area client della finestra specificata.
SetScrollInfo	La funzione SetScrollInfo imposta i parametri di una barra di scorrimento, incluse le posizioni di scorrimento minime e massime, le dimensioni della pagina e la posizione della casella di scorrimento (thumb). La funzione ridisegna anche la barra di scorrimento, se richiesto.
SetScrollPos	La funzione SetScrollPos imposta la posizione della casella di scorrimento (pollice) nella barra di scorrimento specificata e, se richiesto, ridisegna la barra di scorrimento in modo da riflettere la nuova posizione della casella di scorrimento. Nota: la funzione SetScrollPos viene fornita per la compatibilità con le versioni precedenti. Le nuove applicazioni devono usare la funzione SetScrollInfo.
SetScrollRange	La funzione SetScrollRange imposta le posizioni della casella di scorrimento minima e massima per la barra di scorrimento specificata. Nota: la funzione SetScrollRange viene fornita per la compatibilità con le versioni precedenti. Le nuove applicazioni devono usare la funzione SetScrollInfo.
ShowScrollBar	La funzione ShowScrollBar mostra o nasconde la barra di scorrimento specificata.

Messaggi

Argomento	Contenuto
SBM_ENABLE_ARROWS	Un'applicazione invia il messaggio di SBM_ENABLE_ARROWS per abilitare o disabilitare una o entrambe le frecce di un controllo barra di scorrimento.
SBM_GETPOS	Il messaggio SBM_GETPOS viene inviato per recuperare la posizione corrente della casella di scorrimento di un controllo barra di scorrimento. 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. Le applicazioni non devono inviare direttamente questo messaggio. Devono invece usare la funzione GetScrollPos. Una finestra riceve questo messaggio tramite la relativa funzione WindowProc. Le applicazioni che implementano un controllo barra di scorrimento personalizzato devono rispondere a questi messaggi affinché la funzione GetScrollPos funzioni correttamente.
SBM_GETRANGE	Il messaggio SBM_GETRANGE viene inviato per recuperare i valori di posizione minima e massima per il controllo barra di scorrimento. Le applicazioni non devono inviare direttamente questo messaggio. Devono invece usare la funzione GetScrollRange. Una finestra riceve questo messaggio tramite la relativa funzione WindowProc. Le applicazioni che implementano un controllo barra di scorrimento personalizzato devono rispondere a questi messaggi affinché la funzione GetScrollRange funzioni correttamente.
SBM_GETSCROLLBARINFO	Inviato da un'applicazione per recuperare informazioni sulla barra di scorrimento specificata.
SBM_GETSCROLLINFO	Il messaggio SBM_GETSCROLLINFO viene inviato per recuperare i parametri di una barra di scorrimento. Le applicazioni non devono inviare direttamente questo messaggio. Devono invece usare la funzione GetScrollInfo. Una finestra riceve questo messaggio tramite la relativa funzione WindowProc. Le applicazioni che implementano un controllo barra di scorrimento personalizzato devono rispondere a questi messaggi affinché la funzione GetScrollInfo funzioni correttamente.
SBM_edizione Standard TPOS	Il messaggio SBM_edizione Standard TPOS viene inviato per impostare la posizione della casella di scorrimento (pollice) e, se richiesto, ridisegnare la barra di scorrimento per riflettere la nuova posizione della casella di scorrimento. Le applicazioni non devono inviare direttamente questo messaggio. Devono invece usare la funzione SetScrollPos. Una finestra riceve questo messaggio tramite la relativa funzione WindowProc. Le applicazioni che implementano un controllo barra di scorrimento personalizzato devono rispondere a questi messaggi affinché la funzione SetScrollPos funzioni correttamente.
SBM_edizione Standard TRANGE	Il messaggio SBM_edizione Standard TRANGE viene inviato per impostare i valori di posizione minima e massima per il controllo barra di scorrimento. Le applicazioni non devono inviare direttamente questo messaggio. Devono invece usare la funzione SetScrollRange. Una finestra riceve questo messaggio tramite la relativa funzione WindowProc. Le applicazioni che implementano un controllo barra di scorrimento personalizzato devono rispondere a questi messaggi affinché la funzione SetScrollRange funzioni correttamente.
SBM_edizione Standard TRANGEREDRAW	Un'applicazione invia il messaggio SBM_edizione Standard TRANGEREDRAW a un controllo barra di scorrimento per impostare i valori di posizione minimo e massimo e di ridisegnare il controllo.
SBM_edizione Standard TSCROLLINFO	Il messaggio SBM_edizione Standard TSCROLLINFO viene inviato per impostare i parametri di una barra di scorrimento. Le applicazioni non devono inviare direttamente questo messaggio. Devono invece usare la funzione SetScrollInfo. Una finestra riceve questo messaggio tramite la relativa funzione WindowProc. Le applicazioni che implementano un controllo barra di scorrimento personalizzato devono rispondere a questi messaggi affinché la funzione SetScrollInfo funzioni correttamente.

Notifications

Argomento	Contenuto
WM_CTLCOLORSCROLLBAR	Il messaggio WM_CTLCOLORSCROLLBAR viene inviato alla finestra padre di un controllo barra di scorrimento quando il controllo sta per essere disegnato. Rispondendo a questo messaggio, la finestra padre può utilizzare l'handle di contesto di visualizzazione per impostare il colore di sfondo del controllo barra di scorrimento. Una finestra riceve questo messaggio tramite la relativa funzione WindowProc.
WM_HSCROLL	Il messaggio WM_HSCROLL viene inviato a una finestra quando si verifica un evento di scorrimento nella barra di scorrimento orizzontale standard della finestra. Questo messaggio viene inviato anche al proprietario di un controllo barra di scorrimento orizzontale quando si verifica un evento di scorrimento nel controllo . Una finestra riceve questo messaggio tramite la relativa funzione WindowProc.
WM_VSCROLL	Il messaggio WM_VSCROLL viene inviato a una finestra quando si verifica un evento di scorrimento nella barra di scorrimento verticale standard della finestra. Questo messaggio viene inviato anche al proprietario di un controllo barra di scorrimento verticale quando si verifica un evento di scorrimento nel controllo . Una finestra riceve questo messaggio tramite la relativa funzione WindowProc.

Strutture

Argomento	Contenuto
SCROLLBARINFO	La struttura SCROLLBARINFO contiene informazioni sulla barra di scorrimento.
SCROLLINFO	La struttura SCROLLINFO contiene parametri della barra di scorrimento da impostare tramite la funzione SetScrollInfo (o SBM_edizione Standard TSCROLLINFO message) o recuperata dalla funzione GetScrollInfo (o SBM_GETSCROLLINFO messaggio).

Costanti

Argomento	Contenuto
Stili di controllo barra di scorrimento	Per creare un controllo barra di scorrimento usando la funzione CreateWindow o CreateWindowEx, specificare la classe SCROLLBAR, le costanti dello stile di finestra appropriate e una combinazione degli stili di controllo della barra di scorrimento seguenti. Alcuni stili creano un controllo barra di scorrimento che usa una larghezza o un'altezza predefinita. Tuttavia, è necessario specificare sempre le coordinate x e y e le altre dimensioni della barra di scorrimento quando si chiama CreateWindow o CreateWindowEx.

Argomento

Contenuto

Stili di controllo barra di scorrimento

Per creare un controllo barra di scorrimento usando la funzione CreateWindow o CreateWindowEx, specificare la classe SCROLLBAR, le costanti dello stile di finestra appropriate e una combinazione degli stili di controllo della barra di scorrimento seguenti. Alcuni stili creano un controllo barra di scorrimento che usa una larghezza o un'altezza predefinita. Tuttavia, è necessario specificare sempre le coordinate x e y e le altre dimensioni della barra di scorrimento quando si chiama CreateWindow o CreateWindowEx.