Scorrere Box posizione e lo scorrimento di gamma

La posizione della casella di scorrimento è rappresentata come un numero intero; esso è relativo alla estremità sinistra o superiore della barra di scorrimento, a seconda che la barra di scorrimento sia orizzontale o verticale. La posizione deve essere entro i valori minimi e massimi dell'intervallo di scorrimento. Ad esempio, in una barra di scorrimento con un intervallo compreso tra 0 e 100, posizione 50 è nel mezzo, con le posizioni restanti ugualmente distribuite lungo la barra di scorrimento. La gamma iniziale dipende la barra di scorrimento. Barre di scorrimento standard hanno una gamma iniziale di 0 e 100; scorrimento barra controlli dispongono di una gamma di vuota (valori minimo e massimo sono zero), a meno che non si fornisce una gamma esplicita quando il controllo viene creato. È possibile modificare la gamma in qualsiasi momento. È possibile utilizzare la funzione SetScrollInfo per impostare i valori di gamma e la funzione GetScrollInfo per recuperare i valori correnti della gamma.

Un'applicazione regola tipicamente l'intervallo di scorrimento a interi convenienti, rendendo facile per tradurre la posizione della casella di scorrimento in un valore corrispondente all'oggetto dati per scorrere. Ad esempio, se un'applicazione deve visualizzare 260 righe di un file di testo in una finestra che può mostrare solo 16 linee in un momento, la gamma di barra di scorrimento verticale può essere impostata 1 attraverso 244. Se la casella di scorrimento è in posizione 1, la prima linea sarà nella parte superiore della finestra. Se la casella di scorrimento è in posizione 244, l'ultima riga (riga 260) sarà nella parte inferiore della finestra. Se un'applicazione tenta di specificare un valore di posizione che è inferiore al minimo o più quello massimo, il valore di intervallo minimo o massimo scorrimento viene utilizzato invece.

È possibile impostare una dimensione di pagina per una barra di scorrimento. La dimensione della pagina rappresenta il numero di unità di dati in grado di inserirsi nell'area client della finestra del proprietario, data la dimensione corrente. Ad esempio, se l'area client può tenere 16 linee di testo, un'applicazione sarebbe impostare le dimensioni della pagina a 16. Il sistema utilizza le dimensioni della pagina, insieme con la gamma e la lunghezza dell'albero scorrimento, scorrimento per impostare la dimensione della casella di scorrimento. Ogni qualvolta viene ridimensionata una finestra contenente una barra di scorrimento, un'applicazione deve chiamare la funzione SetScrollInfo per impostare le dimensioni della pagina. Un'applicazione può recuperare le dimensioni della pagina corrente chiamando la funzione invio di GetScrollInfo .

Per stabilire una relazione utile tra la gamma di barra di scorrimento e l'oggetto dati, un'applicazione deve regolare la gamma ogni volta che la dimensione dei dati oggetto di modifiche.

Mentre l'utente sposta la casella di scorrimento in una barra di scorrimento, la barra di scorrimento riporta la posizione della casella di scorrimento come valore integer nell'intervallo di scorrimento. Se la posizione è il valore minimo, la casella di scorrimento è nella parte superiore della barra di scorrimento verticale o all'estremità sinistra della barra di scorrimento orizzontale. Se la posizione è il valore massimo, la casella di scorrimento è nella parte inferiore della barra di scorrimento verticale o all'estremità destra della barra di scorrimento orizzontale.

Il valore massimo che può una barra di scorrimento relazione (cioè il massimo scorrimento posizione) dipende dalla dimensione della pagina. Se la barra di scorrimento ha una dimensione maggiore di uno, il massimo scorrimento posizione è inferiore al valore massimo range. È possibile utilizzare la seguente formula per calcolare il posizione di scorrimento massimo:

MaxScrollPos = MaxRangeValue-(PageSize - 1) 
 

Un'applicazione deve muoversi in una barra di scorrimento, la casella di scorrimento. Anche se l'utente effettua una richiesta per lo scorrimento in una barra di scorrimento, la barra di scorrimento non aggiorna automaticamente la posizione della casella di scorrimento. Al contrario, essa trasferisce la richiesta alla finestra padre, che deve scorrere i dati e aggiornare la posizione della casella di scorrimento. Un'applicazione utilizza la funzione SetScrollInfo per aggiornare la posizione della casella di scorrimento; in caso contrario, viene utilizzata la funzione SetScrollPos . Perché esso controlla il movimento di casella di scorrimento, l'applicazione può spostare la casella di scorrimento in incrementi che funzionano meglio per i dati sta durante lo scorrimento.

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

Index