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 キーが押されたかどうかを示す値を取得します。 |
解説
キー イベントは次の順序で発生します。
キーボード イベントをフォームでだけ処理し、そのイベントを他のコントロールでは受け取らないようにする場合は、フォームの 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