ScrollEventArgs Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Fornece dados para o evento de Scroll .

public ref class ScrollEventArgs : EventArgs

[System.Runtime.InteropServices.ComVisible(true)]
public class ScrollEventArgs : EventArgs

public class ScrollEventArgs : EventArgs

[<System.Runtime.InteropServices.ComVisible(true)>]
type ScrollEventArgs = class
    inherit EventArgs

type ScrollEventArgs = class
    inherit EventArgs

Public Class ScrollEventArgs
Inherits EventArgs

Herança

Object

EventArgs

ScrollEventArgs

Atributos

ComVisibleAttribute

Exemplos

O exemplo de código a seguir demonstra o uso desse membro.

void AddMyScrollEventHandlers()
{
   // Create and initialize a VScrollBar.
   VScrollBar^ vScrollBar1 = gcnew VScrollBar;

   // Add event handlers for the OnScroll and OnValueChanged events.
   vScrollBar1->Scroll += gcnew ScrollEventHandler( this, &Form1::vScrollBar1_Scroll );
   vScrollBar1->ValueChanged += gcnew EventHandler( this, &Form1::vScrollBar1_ValueChanged );
}

// Create the ValueChanged event handler.
void vScrollBar1_ValueChanged( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   // Display the new value in the label.
   label1->Text = String::Format( "vScrollBar Value:(OnValueChanged Event) {0}", vScrollBar1->Value );
}

// Create the Scroll event handler.
void vScrollBar1_Scroll( Object^ /*sender*/, ScrollEventArgs^ e )
{
   // Display the new value in the label.
   label1->Text = String::Format( "VScrollBar Value:(OnScroll Event) {0}", e->NewValue );
}

void button1_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   // Add 40 to the Value property if it will not exceed the Maximum value.
   if ( vScrollBar1->Value + 40 < vScrollBar1->Maximum )
   {
      vScrollBar1->Value = vScrollBar1->Value + 40;
   }
}

private void AddMyScrollEventHandlers()
 {
    // Create and initialize a VScrollBar.
    VScrollBar vScrollBar1 = new VScrollBar();
 
    // Add event handlers for the OnScroll and OnValueChanged events.
    vScrollBar1.Scroll += new ScrollEventHandler(
       this.vScrollBar1_Scroll);
    vScrollBar1.ValueChanged += new EventHandler(
       this.vScrollBar1_ValueChanged); 
 }
 
 // Create the ValueChanged event handler.
 private void vScrollBar1_ValueChanged(Object sender, 
                                       EventArgs e)
 {
     // Display the new value in the label.
     label1.Text = "vScrollBar Value:(OnValueChanged Event) " + vScrollBar1.Value.ToString();
 }
 
 // Create the Scroll event handler.
 private void vScrollBar1_Scroll(Object sender, 
                                 ScrollEventArgs e)
 {
     // Display the new value in the label.
     label1.Text = "VScrollBar Value:(OnScroll Event) " + e.NewValue.ToString();
 }
 
 private void button1_Click(Object sender, 
                           EventArgs e)
 {
    // Add 40 to the Value property if it will not exceed the Maximum value.
    if (vScrollBar1.Value + 40 < vScrollBar1.Maximum)
    {
        vScrollBar1.Value = vScrollBar1.Value + 40;
    }
 }

Private Sub AddMyScrollEventHandlers()
    ' Create and initialize a VScrollBar.
    Dim vScrollBar1 As New VScrollBar()
    
    ' Add event handlers for the OnScroll and OnValueChanged events.
    AddHandler vScrollBar1.Scroll, AddressOf Me.vScrollBar1_Scroll
    AddHandler vScrollBar1.ValueChanged, AddressOf Me.vScrollBar1_ValueChanged
End Sub    

' Create the ValueChanged event handler.
Private Sub vScrollBar1_ValueChanged(sender As Object, e As EventArgs)
    ' Display the new value in the label.
    label1.Text = "vScrollBar Value:(OnValueChanged Event) " & _
        vScrollBar1.Value.ToString()
End Sub    

' Create the Scroll event handler.
Private Sub vScrollBar1_Scroll(sender As Object, e As ScrollEventArgs)
    ' Display the new value in the label.
    label1.Text = "VScrollBar Value:(OnScroll Event) " & _
        e.NewValue.ToString()
End Sub    

Private Sub button1_Click(sender As Object, e As EventArgs)
    ' Add 40 to the Value property if it will not exceed the Maximum value.
    If vScrollBar1.Value + 40 < vScrollBar1.Maximum Then
        vScrollBar1.Value = vScrollBar1.Value + 40
    End If
End Sub

Comentários

O Scroll evento ocorre quando o usuário altera o valor da barra de rolagem. Esse evento pode resultar de uma variedade de ações, como clicar em uma seta de barra de rolagem, pressionar a SETA PARA CIMA ou SETA PARA BAIXO ou arrastar a caixa de rolagem. Especifica ScrollEventArgs o tipo de evento de rolagem que ocorreu e o novo valor da barra de rolagem. Use a ScrollOrientation propriedade para determinar a orientação da barra de rolagem para o Scroll evento.

O Scroll evento ocorre para o DataGridView, ScrollableControl, ScrollBare DataGrid controles.

Construtores

ScrollEventArgs(ScrollEventType, Int32)	Inicializa uma nova instância da classe ScrollEventArgs usando os valores fornecidos para as propriedades Type e NewValue.
ScrollEventArgs(ScrollEventType, Int32, Int32)	Inicializa uma nova instância da classe ScrollEventArgs usando os valores fornecidos para as propriedades Type, OldValue e NewValue.
ScrollEventArgs(ScrollEventType, Int32, Int32, ScrollOrientation)	Inicializa uma nova instância da classe ScrollEventArgs usando os valores fornecidos para as propriedades Type, OldValue, NewValue e ScrollOrientation.
ScrollEventArgs(ScrollEventType, Int32, ScrollOrientation)	Inicializa uma nova instância da classe ScrollEventArgs usando os valores fornecidos para as propriedades Type, NewValue e ScrollOrientation.

Propriedades

NewValue	Obtém ou define o novo Value da barra de rolagem.
OldValue	Obtém o antigo Value da barra de rolagem.
ScrollOrientation	Obtém a orientação da barra de rolagem que acionou o evento Scroll.
Type	Obtém o tipo de evento de rolagem que ocorreu.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• Scroll
• ScrollBar
• DataGridView
• DataGrid