Control.KeyUp イベントとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Control.KeyUp イベント

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

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Event KeyUp As KeyEventHandler

Visual Basic (使用法)

Dim instance As Control
Dim handler As KeyEventHandler

AddHandler instance.KeyUp, handler

public event KeyEventHandler KeyUp

C++

public:
event KeyEventHandler^ KeyUp {
    void add (KeyEventHandler^ value);
    void remove (KeyEventHandler^ value);
}

/** @event */
public void add_KeyUp (KeyEventHandler value)

/** @event */
public void remove_KeyUp (KeyEventHandler value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

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

KeyDown
KeyPress
KeyUp

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

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

使用例

KeyUp イベントと Help クラスを使用して、ポップアップスタイルのヘルプをユーザーに表示するコード例を次に示します。

Visual Basic

' 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 handler 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

// 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 handler 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 handler 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", Point(textBox1->Right,this->textBox1->Bottom)
 );
      }
   }

// 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 handler 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.get_KeyCode().Equals(Keys.F1)) {
        // Display a pop-up help topic to assist the user.
        Help.ShowPopup(textBox1, "Enter your first name", 
            new Point(textBox1.get_Right(), this.textBox1.get_Bottom()));
    }
} //textBox1_KeyUp