ScrollableControl.Scroll 事件

定義

發生於使用者或程式碼捲動工作區時。Occurs when the user or code scrolls through the client area.

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

範例

下列程式碼範例將示範如何使用這個成員。The following code example demonstrates the use of this member. 在此範例中,事件處理常式會報告事件的發生情況 ScrollIn the example, an event handler reports on the occurrence of the Scroll event. 這份報告可協助您瞭解發生事件的時間,並協助您進行調試。This report helps you to learn when the event occurs and can assist you in debugging. 若要報告多個事件或經常發生的事件,請考慮將取代為 MessageBox.Show Console.WriteLine 或將訊息附加至多行 TextBoxTo report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

若要執行範例程式碼,請將它貼到專案中,其中包含繼承自之類型的實例 ScrollableControl ,例如 PanelContainerControlTo run the example code, paste it into a project that contains an instance of a type that inherits from ScrollableControl, such as a Panel or ContainerControl. 然後命名實例 ScrollableControl1 ,並確定事件處理常式與事件相關聯 ScrollThen name the instance ScrollableControl1 and ensure that the event handler is associated with the Scroll event.

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當使用者藉由與捲軸互動,或使用者在控制項間導覽,以及使用中控制項滾動至視圖時,就會發生此事件。The Scroll event occurs when the user scrolls through the client area by interacting with the scroll bars, or when the user navigates between controls and the active control scrolls into view. Scroll當您撰寫程式碼(例如設定 AutoScrollPosition 屬性)以在工作區中滾動時,也會發生此事件。The Scroll event also occurs when you write code, such as setting the AutoScrollPosition property, that scrolls through the client area.

您可以使用 ScrollOrientation 事件處理常式中的屬性,判斷事件的捲軸方向 ScrollYou can use the ScrollOrientation property in your event handler to determine the scroll bar orientation for the Scroll event.

如需如何處理事件的詳細資訊,請參閱 處理和引發事件For more information about how to handle events, see Handling and Raising Events.

適用於

另請參閱