コントロール イベント (Windows フォーム .NET)

  • [アーティクル]

コントロールでは、ユーザーがコントロールを操作したとき、またはコントロールの状態が変わったときに発生するイベントを提供します。 この記事では、ほとんどのコントロールで共有される一般的なイベント、ユーザー操作によって発生するイベント、および特定のコントロールに固有のイベントについて説明します。 Windows フォームのイベントの詳細については、イベントの概要とイベントの処理と発生に関するページを参照してください。

コントロール イベント ハンドラーを追加または削除する方法の詳細については、イベントを処理する方法に関するページを参照してください。

一般的なイベント

コントロールは、基底クラス Control を介して 60 を超えるイベントを提供します。 これには、コントロールが描画される原因となる Paint イベント、Resize イベントや Layout イベントなどのウィンドウの表示に関連するイベント、低レベルのマウス イベントとキーボード イベントなどがあります。 一部の低レベルのイベントは、Control によって Click や DoubleClick などのセマンティック イベントに合成されます。 ほとんどの共有イベントは、次のカテゴリに分類されます。

  • マウス イベント
  • キーボード イベント
  • プロパティ変更イベント
  • その他のイベント

マウス イベント

Windows フォームをユーザー インターフェイス (UI) テクノロジと考えた場合、マウス入力は、ユーザーが Windows フォーム アプリケーションを操作する主な方法となります。 すべてのコントロールにより、基本的なマウス関連のイベントが提供されます。

詳細については、マウス イベントの使用に関するページを参照してください。

キーボード イベント

TextBox や Button コントロールなどのコントロールでユーザー入力に応答する場合、そのコントロールに対して適切な入力イベントが発生します。 キーボード イベントを受信するには、コントロールにフォーカスする必要があります。 Label コントロールなどの一部のコントロールにはフォーカスできないので、キーボード イベントを受信できません。 キーボード イベントの一覧を以下に示します。

詳細については、「キーボード イベントの使用」を参照してください。

プロパティ変更イベント

Windows フォームでは、変更イベントを持つプロパティの PropertyNameChanged パターンに従います。 Windows フォームによって提供されるデータ バインディング エンジンでは、このパターンを認識し、それと適切に統合します。 独自のコントロールを作成する場合は、このパターンを実装します。

このパターンでは、FirstName プロパティを例として使用して、次の規則を実装します。

  • プロパティに FirstName という名前を付けます。
  • パターン PropertyNameChanged を使用して、プロパティの次のイベントを作成します: FirstNameChanged
  • パターン OnPropertyNameChanged を使用して、プライベートまたは保護された次のメソッドを作成します: OnFirstNameChanged

FirstName プロパティ セットでバッキング値が変更された場合は、OnFirstNameChanged メソッドが呼び出されます。 OnFirstNameChanged メソッドは、FirstNameChanged イベントを発生させます。

コントロールの一般的なプロパティ変更イベントの一部を以下に示します。

Event 説明
BackColorChanged BackColor プロパティの値が変化したときに発生します。
BackgroundImageChanged BackgroundImage プロパティの値が変化したときに発生します。
BindingContextChanged BindingContext プロパティの値が変化したときに発生します。
DockChanged Dock プロパティの値が変化したときに発生します。
EnabledChanged Enabled プロパティ値が変更されたときに発生します。
FontChanged Font プロパティの値が変化すると発生します。
ForeColorChanged ForeColor プロパティの値が変化すると発生します。
LocationChanged Location プロパティ値が変更されたときに発生します。
SizeChanged Size プロパティの値が変化すると発生します。
VisibleChanged Visible プロパティの値が変化すると発生します。

イベントの完全な一覧については、「Control クラス」の「イベント」セクションを参照してください。

その他のイベント

また、コントロールでは、コントロールの状態、またはコントロールのその他の操作に基づいてイベントが発生します。 たとえば、コントロールにフォーカスがあり、ユーザーが F1 キーを押すと、HelpRequested イベントが発生します。 このイベントは、ユーザーがフォームの状況依存の [ヘルプ] ボタンを押してから、コントロールのヘルプ カーソルを押した場合にも発生します。

もう 1 つの例として、コントロールが変更、移動、またはサイズ変更された場合、Paint イベントが発生します。 このイベントにより、開発者はコントロールに描画し、その外観を変更できるようになります。

イベントの完全な一覧については、「Control クラス」の「イベント」セクションを参照してください。

こちらもご覧ください