ScrollableControl.Scroll Evento

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ocorre quando o usuário ou o código percorre a área de cliente.

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 de evento

ScrollEventHandler

Exemplos

O exemplo de código a seguir demonstra o uso desse membro. No exemplo, um manipulador de eventos relata a ocorrência do Scroll evento. Este relatório ajuda você a aprender quando o evento ocorre e pode ajudá-lo na depuração. Para relatar vários eventos ou eventos que ocorrem com frequência, considere substituir MessageBox.ShowConsole.WriteLine ou acrescentar a mensagem a uma multilinha TextBox.

Para executar o código de exemplo, cole-o em um projeto que contém uma instância de um tipo que herda de ScrollableControl, como um Panel ou ContainerControl. Em seguida, nomeie a instância ScrollableControl1 e verifique se o manipulador de eventos está associado ao Scroll evento.

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

Comentários

O Scroll evento ocorre quando o usuário rola pela área do cliente interagindo com as barras de rolagem ou quando o usuário navega entre controles e o controle ativo rola para a exibição. O Scroll evento também ocorre quando você escreve código, como definir a AutoScrollPosition propriedade , que rola pela área do cliente.

Você pode usar a ScrollOrientation propriedade em seu manipulador de eventos para determinar a orientação da barra de rolagem para o Scroll evento.

Para obter mais informações sobre como lidar com eventos, consulte Manipulando e levantando eventos.

Confira também

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