ScrollableControl.Scroll イベント


ユーザーまたはコードによってクライアント領域がスクロールされたときに発生します。Occurs when the user or code scrolls through the client area.

 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 

このメンバーの使用例を次のコード例に示します。The following code example demonstrates the use of this member. この例では、イベントハンドラーは、Scroll イベントの発生を報告します。In 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.ShowConsole.WriteLine に置き換えるか、複数行 TextBoxにメッセージを追加することを検討してください。To 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.

コード例を実行するには、PanelContainerControlなどの ScrollableControlから継承する型のインスタンスを含むプロジェクトに貼り付けます。To 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 という名前を付け、イベントハンドラーが Scroll イベントに関連付けられていることを確認します。Then 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.AppendFormat("{0} = {1}", "Type", e.Type );
messageBoxCS.AppendFormat("{0} = {1}", "NewValue", e.NewValue );
messageBoxCS.AppendFormat("{0} = {1}", "OldValue", e.OldValue );
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.AppendFormat("{0} = {1}", "Type", e.Type)
    messageBoxVB.AppendFormat("{0} = {1}", "NewValue", e.NewValue)
    messageBoxVB.AppendFormat("{0} = {1}", "OldValue", e.OldValue)
    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 プロパティを使用して、Scroll イベントのスクロールバーの方向を決定できます。You 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.