ScrollableControl.Scroll ScrollableControl.Scroll ScrollableControl.Scroll ScrollableControl.Scroll Event

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 

Esempi

Esempio di codice seguente viene illustrato l'utilizzo di questo membro.The following code example demonstrates the use of this member. Nell'esempio, un gestore dell'evento segnala l'occorrenza del Scroll evento.In the example, an event handler reports on the occurrence of the Scroll event. Questo report consente di capire quando l'evento si verifica e può agevolare 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, prendere in considerazione la sostituzione MessageBox.Show con Console.WriteLine o aggiungere il messaggio a una proprietà multiline TextBox.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 l'esempio di codice, 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. Quindi assegnare un nome istanza ScrollableControl1 e assicurarsi che il gestore dell'evento è associato il Scroll evento.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

Il Scroll evento si verifica quando l'utente scorre l'area client tramite l'interazione con le barre di scorrimento, oppure quando l'utente si sposta tra i controlli e scorre il controllo attivo all'interno della 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. Il Scroll evento si verifica anche quando si scrive codice, ad esempio impostando il AutoScrollPosition proprietà, 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 ScrollOrientation proprietà nel gestore eventi per determinare l'orientamento della barra di scorrimento per il Scroll evento.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