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 発生を報告します。 このレポートは、イベントが発生したタイミングを知るのに役立ち、デバッグに役立ちます。 複数のイベントまたは頻繁に発生するイベントを報告するには、 を Console.WriteLine に置き換えるかMessageBox.Show、複数行TextBoxにメッセージを追加することを検討してください。

コード例を実行するには、 や ContainerControlなどPanel、 からScrollableControl継承する型のインスタンスを含むプロジェクトに貼り付けます。 次に、インスタンス 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)