ScrollableControl.Scroll Zdarzenie
Definicja
Ważny
Niektóre informacje dotyczą produktów przedpremierowych, które mogą zostać znacznie zmodyfikowane przed premierą. Microsoft nie udziela żadnych gwarancji, ani wyraźnych, ani domniemanych, dotyczących informacji podanych tutaj.
Występuje, gdy użytkownik lub kod przewija obszar klienta.
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
Typ wydarzenia
Przykłady
Poniższy przykład kodu przedstawia użycie tego elementu członkowskiego. W tym przykładzie program obsługi zdarzeń zgłasza wystąpienie zdarzenia Scroll . Ten raport pomaga dowiedzieć się, kiedy wystąpi zdarzenie i może pomóc w debugowaniu. Aby zgłosić wiele zdarzeń lub zdarzeń, które występują często, rozważ zastąpienie MessageBox.Show komunikatu ciągiem Console.WriteLine lub dołączeniem go do wielowierszowego TextBoxelementu .
Aby uruchomić przykładowy kod, wklej go w projekcie zawierającym wystąpienie typu dziedziczonego z ScrollableControlelementu , takiego jak Panel lub ContainerControl. Następnie nadaj wystąpieniu ScrollableControl1 nazwę i upewnij się, że program obsługi zdarzeń jest skojarzony ze zdarzeniem Scroll .
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
Uwagi
Zdarzenie Scroll występuje, gdy użytkownik przewija obszar klienta przez interakcję z paskami przewijania lub gdy użytkownik przechodzi między kontrolkami i aktywnymi przewijaniami w widoku. Zdarzenie Scroll występuje również podczas pisania kodu, takiego jak ustawienie AutoScrollPosition właściwości, która przewija obszar klienta.
Właściwość można użyć ScrollOrientation w procedurze obsługi zdarzeń, aby określić orientację paska przewijania Scroll dla zdarzenia.
Aby uzyskać więcej informacji na temat obsługi zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.