Control.Leave イベント

定義

入力フォーカスがコントロールを離れると発生します。

C#
public event EventHandler Leave;
C#
public event EventHandler? Leave;

イベントの種類

次のコード例では、 イベントを Leave 使用してコントロールを以前の状態にリセットします。

C#
private void textBox1_Enter(object sender, System.EventArgs e)
{
    // If the TextBox contains text, change its foreground and background colors.
    if (!string.IsNullOrEmpty(textBox1.Text))
    {
        textBox1.ForeColor = Color.Red;
        textBox1.BackColor = Color.Black;
        // Move the selection pointer to the end of the text of the control.
        textBox1.Select(textBox1.Text.Length, 0);
    }
}

private void textBox1_Leave(object sender, System.EventArgs e)
{
    // Reset the colors and selection of the TextBox after focus is lost.
    textBox1.ForeColor = Color.Black;
    textBox1.BackColor = Color.White;
    textBox1.Select(0,0);
}

注釈

キーボード (TAB、Shift + TAB など) を使用してフォーカスを変更する場合、 メソッドまたは SelectNextControl メソッドをSelect呼び出すか、 プロパティをContainerControl.ActiveControl現在のフォームに設定すると、フォーカス イベントは次の順序で発生します。

  1. Enter

  2. GotFocus

  3. Leave

  4. Validating

  5. Validated

  6. LostFocus

マウスを使用するか、 メソッドを呼び出してフォーカスを Focus 変更すると、フォーカス イベントは次の順序で発生します。

  1. Enter

  2. GotFocus

  3. LostFocus

  4. Leave

  5. Validating

  6. Validated

プロパティが CausesValidationfalse設定されている場合、 Validating イベントと Validated イベントは抑制されます。

注意

Enterイベントと Leave イベントは、 クラスによってForm抑制されます。 クラス内の同等の Form イベントは、 Activated イベントと Deactivate イベントです。 Enterイベントと Leave イベントは階層構造であり、適切なコントロールに到達するまで親チェーンを上下にカスケードします。 たとえば、 には Form 2 つの GroupBox コントロールがあり、各 GroupBox コントロールには 1 つの TextBox コントロールがあるとします。 キャレットを一方TextBoxから他方に移動すると、 LeaveGroupBoxに対TextBoxしてイベントが発生し、もう一方GroupBoxTextBoxEnter に対してイベントが発生します。

注意事項

、または イベント ハンドラー内からフォーカスをEnterGotFocusLostFocusLeaveValidating設定しないでください。Validated これにより、アプリケーションまたはオペレーティング システムが応答を停止する可能性があります。 詳細については、 WM_KILLFOCUSトピックを 参照してください。

イベントの処理の詳細については、「処理とイベントの発生」を参照してください。

適用対象

製品 バージョン
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

こちらもご覧ください