Condividi tramite

Barra di scorrimento

  • Articolo

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 di 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_VSCROLLo entrambi gli stili.

Funzioni

Argomento Contenuto
EnableScrollBar La funzioneEnableScrollBarabilita o disabilita una o entrambe le frecce della barra di scorrimento.
GetScrollBarInfo La funzioneGetScrollBarInforecupera 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 funzioneGetScrollPosrecupera 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 funzioneGetScrollPosviene fornita per la compatibilità con le versioni precedenti. Le nuove applicazioni devono usare la funzioneGetScrollInfo.
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 diGetScrollRangeviene fornita solo per la compatibilità. Le nuove applicazioni devono usare la funzioneGetScrollInfo.
ScrollDC La funzioneScrollDCscorre un rettangolo di bit orizzontalmente e verticalmente.
ScrollWindow La funzione ScrollWindowscorre il contenuto dell'area client della finestra specificata. Nota: la funzione ScrollWindowviene fornita per la compatibilità con le versioni precedenti. Le nuove applicazioni devono usare la funzioneScrollWindowEx.
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 funzioneSetScrollPosviene fornita per la compatibilità con le versioni precedenti. Le nuove applicazioni devono usare la funzionesetScrollInfo.
SetScrollRange La funzioneSetScrollRangeimposta le posizioni della casella di scorrimento minima e massima per la barra di scorrimento specificata. Nota: la funzione diSetScrollRangeè disponibile per la compatibilità con le versioni precedenti. Le nuove applicazioni devono usare la funzionesetScrollInfo.
ShowScrollBar La funzioneshowScrollBarmostra 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. È invece consigliabile usare la funzioneGetScrollPos. 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 per il corretto funzionamento della funzione GetScrollPos.
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 funzioneGetScrollRange. 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 per il corretto funzionamento della funzione GetScrollRange.
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 funzioneGetScrollInfo. 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 per il corretto funzionamento della funzione GetScrollInfo.
SBM_SETPOS Il messaggio SBM_SETPOS viene inviato per impostare la posizione della casella di scorrimento (pollice) e, se richiesto, ridisegnare la barra di scorrimento in modo da 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 per il corretto funzionamento della funzione SetScrollPos.
SBM_SETRANGE Il messaggio SBM_SETRANGE 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 funzionesetScrollRange. 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 per il corretto funzionamento della funzione SetScrollRange.
SBM_SETRANGEREDRAW Un'applicazione invia il messaggio di SBM_SETRANGEREDRAW a un controllo barra di scorrimento per impostare i valori di posizione minimo e massimo e di ridisegnare il controllo.
SBM_SETSCROLLINFO Il messaggio SBM_SETSCROLLINFO viene inviato per impostare i parametri di una barra di scorrimento.
Le applicazioni non devono inviare direttamente questo messaggio. Devono invece usare la funzioneSetScrollInfo. 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.

Notifiche

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 strutturaSCROLLBARINFOcontiene informazioni sulla barra di scorrimento.
SCROLLINFO La struttura diSCROLLINFOcontiene i parametri della barra di scorrimento da impostare dalla funzioneSetScrollInfo(o SBM_SETSCROLLINFO messaggio) o recuperata dalla funzioneGetScrollInfo(o SBM_GETSCROLLINFO messaggio).

Costanti

Argomento Contenuto
stili di controllo barra di scorrimento Per creare un controllo barra di scorrimento utilizzando la CreateWindow o funzione 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.