ScrollableControl.Scroll イベント
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ユーザーまたはコードがクライアント領域をスクロールしたときに発生します。
public:
event System::Windows::Forms::ScrollEventHandler ^ Scroll;
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
イベントの種類
例
次のコード例は、このメンバーの使用方法を示しています。 この例では、イベント ハンドラーは、 Scroll イベントの発生を報告します。 このレポートは、イベントがいつ発生するかを学習するのに役立ち、デバッグに役立ちます。 複数のイベントや頻繁に発生するイベントについて報告するには、 MessageBox.Show を Console.WriteLine に置き換えるか、メッセージを複数行の TextBoxに追加することを検討してください。
コード例を実行するには、PanelやContainerControlなど、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 イベントのスクロール バーの向きを決定できます。
イベントの処理方法の詳細については、「イベントの 処理と発生」を参照してください。