ScrollableControl.Scroll Evento

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Si verifica quando l'utente o il codice scorre l'area client.

public:
 event System::Windows::Forms::ScrollEventHandler ^ Scroll;

public event System.Windows.Forms.ScrollEventHandler? Scroll;

member this.Scroll : System.Windows.Forms.ScrollEventHandler 

Public Custom Event Scroll As ScrollEventHandler 

Tipo evento

ScrollEventHandler

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questo membro. Nell'esempio un gestore eventi segnala l'occorrenza dell'evento Scroll . Questo report consente di apprendere quando si verifica l'evento e può essere utile per eseguire il debug. Per segnalare più eventi o eventi che si verificano spesso, è consigliabile sostituire MessageBox.Show con Console.WriteLine o aggiungere il messaggio a una multilinea TextBox.

Per eseguire il codice di esempio, incollarlo in un progetto contenente un'istanza di un tipo che eredita da ScrollableControl, ad esempio un Panel oggetto o ContainerControl. Assegnare quindi un nome all'istanza ScrollableControl1 e assicurarsi che il gestore eventi sia associato all'evento Scroll .

private void ScrollableControl1_Scroll(Object sender, ScrollEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "ScrollOrientation", e.ScrollOrientation );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Type", e.Type );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "NewValue", e.NewValue );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "OldValue", e.OldValue );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "Scroll Event" );
}

Private Sub ScrollableControl1_Scroll(sender as Object, e as ScrollEventArgs) _ 
     Handles ScrollableControl1.Scroll

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "ScrollOrientation", e.ScrollOrientation)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Type", e.Type)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "NewValue", e.NewValue)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "OldValue", e.OldValue)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"Scroll Event")

End Sub

Commenti

L'evento Scroll si verifica quando l'utente scorre attraverso l'area client interagendo con le barre di scorrimento oppure quando l'utente passa tra controlli e il controllo attivo scorre nella visualizzazione. L'evento Scroll si verifica anche quando si scrive codice, ad esempio impostando la proprietà, che scorre attraverso l'area AutoScrollPosition client.

È possibile usare la ScrollOrientation proprietà nel gestore eventi per determinare l'orientamento della barra di scorrimento per l'evento Scroll .

Per altre informazioni su come gestire gli eventi, vedere la gestione e generazione di eventi.

Vedi anche

• AutoScrollPosition
• ScrollControlIntoView(Control)
• ScrollToControl(Control)