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. この例では、イベントハンドラーがイベントの発生を報告し 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.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 Panel ContainerControl ます。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.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 イベントのスクロールバーの方向を決定することができ 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.

適用対象

こちらもご覧ください