ScrollableControl.Scroll Evento
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Ocorre quando o utilizador ou código percorre a área do cliente.
public:
event System::Windows::Forms::ScrollEventHandler ^ Scroll;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
Exemplos
O seguinte exemplo de código demonstra a utilização deste elemento. No exemplo, um gestor de eventos reporta a ocorrência do Scroll evento. Este relatório ajuda-o a saber quando o evento ocorre e pode ajudá-lo na depuração. Para reportar múltiplos eventos ou eventos que ocorrem frequentemente, considere substituir MessageBox.Show ou Console.WriteLine anexar a mensagem a uma multilinha TextBox.
Para executar o código de exemplo, cole-o num projeto que contenha uma instância de um tipo que herda de ScrollableControl, como um Panel ou ContainerControl. Depois, nomeie a instância ScrollableControl1 e assegure que o gestor 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
Observações
O Scroll evento ocorre quando o utilizador percorre a área do cliente interagindo com as barras de scroll, ou quando o utilizador navega entre os controlos e o controlo ativo aparece na vista. O Scroll evento também ocorre quando escreves código, como definir a AutoScrollPosition propriedade, que percorre a área do cliente.
Podes usar a ScrollOrientation propriedade no teu gestor de eventos para determinar a orientação da barra de deslocamento do Scroll evento.
Para mais informações sobre como gerir eventos, consulte Gestão e Levantamento de Eventos.
