ScrollableControl.Scroll Evento

Definizione

Si verifica quando l'utente o il codice scorre l'area client.Occurs when the user or code scrolls through the client area.

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 

Esempio

Nell'esempio di codice riportato di seguito viene illustrato l'utilizzo di questo membro.The following code example demonstrates the use of this member. Nell'esempio, un gestore eventi segnala l'occorrenza dell'evento Scroll.In the example, an event handler reports on the occurrence of the Scroll event. Questo report consente di apprendere quando si verifica l'evento e può facilitare il debug.This report helps you to learn when the event occurs and can assist you in debugging. Per creare report su più eventi o sugli eventi che si verificano di frequente, è consigliabile sostituire MessageBox.Show con Console.WriteLine o accodare il messaggio a una TextBoxa più righe.To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

Per eseguire il codice di esempio, incollarlo in un progetto che contiene un'istanza di un tipo che eredita da ScrollableControl, ad esempio un Panel o ContainerControl.To run the example code, paste it into a project that contains an instance of a type that inherits from ScrollableControl, such as a Panel or ContainerControl. Assegnare quindi un nome all'istanza ScrollableControl1 e assicurarsi che il gestore eventi sia associato all'evento Scroll.Then name the instance ScrollableControl1 and ensure that the event handler is associated with the Scroll event.

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 l'area client interagendo con le barre di scorrimento o quando l'utente si sposta tra i controlli e il controllo attivo scorre nella visualizzazione.The Scroll event occurs when the user scrolls through the client area by interacting with the scroll bars, or when the user navigates between controls and the active control scrolls into view. L'evento Scroll si verifica anche quando si scrive il codice, ad esempio impostando la proprietà AutoScrollPosition, che scorre l'area client.The Scroll event also occurs when you write code, such as setting the AutoScrollPosition property, that scrolls through the client area.

È possibile usare la proprietà ScrollOrientation nel gestore eventi per determinare l'orientamento della barra di scorrimento per l'evento di Scroll.You can use the ScrollOrientation property in your event handler to determine the scroll bar orientation for the Scroll event.

Per altre informazioni su come gestire gli eventi, vedere la gestione e generazione di eventi.For more information about how to handle events, see Handling and Raising Events.

Si applica a

Vedi anche