次の方法で共有


Control.KeyUp イベント

コントロールにフォーカスがあるときにキーが離されると発生します。

Public Event KeyUp As KeyEventHandler
[C#]
public event KeyEventHandler KeyUp;
[C++]
public: __event KeyEventHandler* KeyUp;

[JScript] JScript では、このクラスで定義されているイベントを処理できます。ただし、独自に定義することはできません。

イベント データ

イベント ハンドラが、このイベントに関連するデータを含む、KeyEventArgs 型の引数を受け取りました。次の KeyEventArgs プロパティには、このイベントの固有の情報が記載されます。

プロパティ 説明
Alt Alt キーが押されたかどうかを示す値を取得します。
Control Ctrl キーが押されたかどうかを示す値を取得します。
Handled イベントが処理されたかどうかを示す値を取得または設定します。
KeyCode KeyDown イベントまたは KeyUp イベントのキーボード コードを取得します。
KeyData KeyDown イベントまたは KeyUp イベントのキー データを取得します。
KeyValue KeyDown イベントまたは KeyUp イベントのキーボード値を取得します。
Modifiers KeyDown イベントまたは KeyUp イベントの修飾フラグを取得します。修飾子キー (Ctrl、Shift、および Alt) の中で、どのキーの組み合わせが押されたのかを示します。
Shift Shift キーが押されたかどうかを示す値を取得します。

解説

キー イベントは次の順序で発生します。

  1. KeyDown
  2. KeyPress
  3. KeyUp

キーボード イベントをフォームでだけ処理し、そのイベントを他のコントロールでは受け取らないようにする場合は、フォームの KeyPress イベント処理メソッドの KeyPressEventArgs.Handled プロパティを true に設定します。Tab キー、Enter キー、Esc キー、方向キーなどは、コントロールによって自動処理されます。これらのキーで KeyUp イベントを発生させるには、フォーム上の各コントロールで IsInputKey メソッドをオーバーライドする必要があります。 IsInputKey のオーバーライドのコードは、特殊なキーのいずれかが押され、そのキーが true の値を返したかどうかを判断する必要があります。

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

.NET Compact Framework - Windows CE .NET プラットフォームに関する注意点: Service Pack 2 以降では、 Control 基本クラスの他に、コントロール上でこのイベントがサポートされています。サービスパックのご利用に関する情報については、Smart Devices Developer Community の Web サイト (https://go.microsoft.com/fwlink/?LinkId=16561) を参照してください。

使用例

 
' This example demonstrates how to use the KeyUp event with the Help class to display
' pop-up style help to the user of the application. When the user presses F1, the Help
' class displays a pop-up window, similar to a ToolTip, near the control. This example assumes
' that a TextBox control, named textBox1, has been added to the form and its KeyUp
' event has been contected to this event handling method.
Private Sub textBox1_KeyUp(ByVal sender As Object, ByVal e As System.Windows.Forms.KeyEventArgs) Handles textBox1.KeyUp
    ' Determine whether the key entered is the F1 key. Display help if it is.
    If e.KeyCode = Keys.F1 Then
        ' Display a pop-up help topic to assist the user.
        Help.ShowPopup(textBox1, "Enter your first name", New Point(textBox1.Right, Me.textBox1.Bottom))
    End If
End Sub 'textBox1_KeyUp

[C#] 
// This example demonstrates how to use the KeyUp event with the Help class to display
// pop-up style help to the user of the application. When the user presses F1, the Help
// class displays a pop-up window, similar to a ToolTip, near the control. This example assumes
// that a TextBox control, named textBox1, has been added to the form and its KeyUp
// event has been contected to this event handling method.
private void textBox1_KeyUp(object sender, System.Windows.Forms.KeyEventArgs e)
{
    // Determine whether the key entered is the F1 key. Display help if it is.
    if(e.KeyCode == Keys.F1)
    {
        // Display a pop-up help topic to assist the user.
        Help.ShowPopup(textBox1, "Enter your first name", new Point(textBox1.Right, this.textBox1.Bottom));
    }
}

[C++] 
// This example demonstrates how to use the KeyUp event with the Help class to display
// pop-up style help to the user of the application. When the user presses F1, the Help
// class displays a pop-up window, similar to a ToolTip, near the control. This example assumes
// that a TextBox control, named textBox1, has been added to the form and its KeyUp
// event has been connected to this event handling method.
private:
void textBox1_KeyUp(Object* /*sender*/, System::Windows::Forms::KeyEventArgs* e)
{
   // Determine whether the key entered is the F1 key. Display help if it is.
   if(e->KeyCode == Keys::F1)
   {
      // Display a pop-up help topic to assist the user.
      Help::ShowPopup(textBox1, S"Enter your first name",
         Point(textBox1->Right, this->textBox1->Bottom));
   }
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

Control クラス | Control メンバ | System.Windows.Forms 名前空間 | OnKeyUp