ScrollableControl.Scroll Событие

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Происходит в том случае, если пользователь или программа выполняет прокрутку в клиентской области.

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 

Тип события

ScrollEventHandler

Примеры

В следующем примере кода показано использование этого элемента. В этом примере обработчик событий сообщает о возникновении Scroll события. Этот отчет поможет вам узнать, когда происходит событие, и может помочь в отладке. Чтобы сообщить о нескольких событиях или о событиях, которые происходят часто, рекомендуется заменить MessageBox.ShowConsole.WriteLine сообщение на или добавить его в многостроочный TextBox.

Чтобы выполнить пример кода, вставьте его в проект, содержащий экземпляр типа, наследуемого от ScrollableControl, например Panel или ContainerControl. Затем присвойте экземпляру ScrollableControl1 имя и убедитесь, что обработчик событий связан с событием 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

Комментарии

Это Scroll событие возникает, когда пользователь прокручивает клиентную область, взаимодействуя с полосами прокрутки, или когда пользователь перемещается между элементами управления, а активный элемент управления прокручивается в поле зрения. Событие Scroll также возникает при написании кода, например задания AutoScrollPosition свойства, который прокручивается по клиентской области.

Вы можете использовать ScrollOrientation свойство в обработчике событий, чтобы определить ориентацию полосы прокрутки Scroll для события.

Дополнительные сведения об обработке событий см. в разделе Обработка и создание событий.

См. также раздел

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