ScrollableControl.Scroll Evento

Definición

Se produce cuando el usuario o el código se desplaza a través del área cliente.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 

Ejemplos

En el ejemplo de código siguiente se muestra el uso de este miembro.The following code example demonstrates the use of this member. En el ejemplo, un controlador de eventos informa sobre la aparición del Scroll evento.In the example, an event handler reports on the occurrence of the Scroll event. Este informe le ayuda a saber cuándo se produce el evento y puede ayudarle a depurar.This report helps you to learn when the event occurs and can assist you in debugging. Para notificar varios eventos o eventos que se producen con frecuencia, considere MessageBox.Show la Console.WriteLine posibilidad de reemplazar por o anexar el TextBoxmensaje a una multilínea.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.

Para ejecutar el código de ejemplo, péguelo en un proyecto que contenga una instancia de un tipo que herede de ScrollableControl, Panel como 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. A continuación, asigne ScrollableControl1 un nombre a la instancia y asegúrese de que el Scroll controlador de eventos está asociado al 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

Comentarios

El Scroll evento tiene lugar cuando el usuario se desplaza por el área de cliente interactuando con las barras de desplazamiento, o cuando el usuario navega por los controles y el control activo se desplaza a la vista.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. El Scroll evento también se produce cuando se escribe código, como establecer la AutoScrollPosition propiedad, que se desplaza a través del área cliente.The Scroll event also occurs when you write code, such as setting the AutoScrollPosition property, that scrolls through the client area.

Puede utilizar la ScrollOrientation propiedad en el controlador de eventos para determinar la orientación de la barra de Scroll desplazamiento para el evento.You can use the ScrollOrientation property in your event handler to determine the scroll bar orientation for the Scroll event.

Para obtener más información acerca de cómo controlar eventos, vea controlar y provocar eventos.For more information about how to handle events, see Handling and Raising Events.

Se aplica a

Consulte también: