KeyPressEventArgs.KeyChar プロパティ

定義

押されたキーに対応する文字を取得または設定します。Gets or sets the character corresponding to the key pressed.

public:
 property char KeyChar { char get(); void set(char value); };
public:
 property char KeyChar { char get(); };
public char KeyChar { get; set; }
public char KeyChar { get; }
member this.KeyChar : char with get, set
member this.KeyChar : char
Public Property KeyChar As Char
Public ReadOnly Property KeyChar As Char

プロパティ値

Char

作成される ASCII 文字。The ASCII character that is composed. たとえば、ユーザーが Shift キーを押しながら K キーを押した場合、このプロパティは大文字の K を返します。For example, if the user presses SHIFT + K, this property returns an uppercase K.

次の例では、コントロールを作成し TextBox ます。The following example creates a TextBox control. メソッドは、 keypressed プロパティを使用し KeyChar て、enter キーが押されたかどうかを確認します。The keypressed method uses the KeyChar property to check whether the ENTER key pressed. ENTER キーが押されている場合、 Handled プロパティはに設定され true ます。これは、イベントが処理されることを示します。If the ENTER key is pressed, the Handled property is set to true, which indicates the event is handled.

#using <System.dll>
#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>

using namespace System;
using namespace System::Windows::Forms;

public ref class Form1: public Form
{
public:
   Form1()
   {
      // Create a TextBox control.
      TextBox^ tb = gcnew TextBox;
      this->Controls->Add( tb );
      tb->KeyPress += gcnew KeyPressEventHandler( this, &Form1::keypressed );
   }

private:
   void keypressed( Object^ /*o*/, KeyPressEventArgs^ e )
   {
      // The keypressed method uses the KeyChar property to check 
      // whether the ENTER key is pressed. 
      // If the ENTER key is pressed, the Handled property is set to true, 
      // to indicate the event is handled.
      if ( e->KeyChar == (char)13 )
            e->Handled = true;
   }
};

int main()
{
   Application::Run( gcnew Form1 );
}

using System;
using System.Windows.Forms;

public class Form1: Form
{
    public Form1()
    {
        // Create a TextBox control.
        TextBox tb = new TextBox();
        this.Controls.Add(tb);
        tb.KeyPress += new KeyPressEventHandler(keypressed);
    }

    private void keypressed(Object o, KeyPressEventArgs e)
    {
        // The keypressed method uses the KeyChar property to check 
        // whether the ENTER key is pressed. 

        // If the ENTER key is pressed, the Handled property is set to true, 
        // to indicate the event is handled.
        if (e.KeyChar == (char)Keys.Return)
        {
            e.Handled = true;
        }
    }

    public static void Main()
    {
        Application.Run(new Form1());
    }
}
Imports System.Windows.Forms

Public Class Form1
    Inherits Form

    Public Sub New()
        ' Create a TextBox control.
        Dim tb As New TextBox()
        Me.Controls.Add(tb)
        AddHandler tb.KeyPress, AddressOf keypressed
    End Sub

    Private Sub keypressed(ByVal o As [Object], ByVal e As KeyPressEventArgs)
        ' The keypressed method uses the KeyChar property to check 
        ' whether the ENTER key is pressed. 

        ' If the ENTER key is pressed, the Handled property is set to true, 
        ' to indicate the event is handled.

        If e.KeyChar = Microsoft.VisualBasic.ChrW(Keys.Return) Then
            e.Handled = True
        End If
    End Sub

    Public Shared Sub Main()
        Application.Run(New Form1())
    End Sub
End Class

注釈

実行時 KeyChar にキーストロークをサンプリングし、特殊な実行時の状況でキーストロークを変更するには、プロパティを使用します。Use the KeyChar property to sample keystrokes at run time and to modify keystrokes under special run-time circumstances. たとえば、を使用して、 KeyChar ユーザーが郵便番号を入力したときに数値以外の keypresses を無効にしたり、データ入力フィールドで英字の keypresses をすべて大文字に変更したり、キーボードなどのキー入力デバイスで特定のキーの組み合わせを監視したりできます。For example, you can use KeyChar to disable non-numeric keypresses when the user enters a ZIP code, change all alphabetical keypresses to uppercase in a data entry field, or monitor the keyboard or other key input device for specific key combinations.

次のキーを取得または設定できます。You can get or set the following keys:

  • a-z、a-z。a-z, A-Z.

  • +.CTRL.

  • 句読点。Punctuation marks.

  • キーボードの上部とテンキーの両方で、数字キー。Number keys, both across the top of the keyboard and on the numeric keypad.

  • を入力し.ENTER.

次のキーを取得または設定することはできません。You cannot get or set the following keys:

  • Tab キー。The TAB key.

  • 挿入と削除。INSERT and DELETE.

  • 出張.HOME.

  • 終わり。END.

  • Pageup と pagedown。PAGE UP and PAGE DOWN.

  • F1 + F2F1-F2.

  • 押し.ALT.

  • 方向キーArrow keys.

注意

上記の文字以外のキーを検出する方法の詳細については、クラスを参照してください KeyEventArgsFor information about how to detect any of the non-character keys mentioned above, see the KeyEventArgs class.

適用対象

こちらもご覧ください