KeyPressEventArgs.KeyChar プロパティ

押されたキーに対応する文字を取得します。

Public ReadOnly Property KeyChar As Char
[C#]
public char KeyChar {get;}
[C++]
public: __property __wchar_t get_KeyChar();
[JScript]
public function get KeyChar() : Char;

プロパティ値

作成される ASCII 文字。たとえば、ユーザーが Shift キーを押しながら K キーを押す場合、プロパティは大文字の K を取得します。

使用例

[Visual Basic, C#, C++] TextBox コントロールを作成する例を次に示します。 keypressed メソッドは、 KeyChar プロパティを使用して Enter キーが押されたかどうかを確認します。Enter キーが押された場合、 Handled プロパティは true に設定され、イベントが処理されることを示します。

 
Imports System
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 'New

    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(13) Then
            e.Handled = True
        End If
    End Sub 'keypressed

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

[C#] 

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);
    }

    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;
    }

    public static void Main()
    {
        Application.Run(new Form1());
    }
}

[C++] 

#using <mscorlib.dll>
#using <System.dll>
#using <System.Windows.Forms.dll>
using namespace System;
using namespace System::Windows::Forms;

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

    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(new Form1());
}

[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 ファミリ, .NET Compact Framework - Windows CE .NET

参照

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