KeyPressEventArgs.KeyChar 属性
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
获取或设置与按下的键对应的字符。
public:
property char KeyChar { char get(); };public:
property char KeyChar { char get(); void set(char value); };C#
public char KeyChar { get; }C#
public char KeyChar { get; set; }member this.KeyChar : charmember this.KeyChar : char with get, setPublic ReadOnly Property KeyChar As CharPublic Property KeyChar As Char撰写的 ASCII 字符。 例如，如果用户按下 Shift + K，则该属性返回一个大写的 K。
以下示例创建一个 TextBox 控件。 该方法 keypressed 使用 KeyChar 属性检查 ENTER 键是否按下。 如果按下 ENTER 键，则会 Handled 将属性设置为 true，该属性指示事件已处理。
#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 );
}
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);
}
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使用属性在运行时对击键进行采样，并在特殊运行时情况下修改击键。 例如，当用户输入邮政编码时，可用于 KeyChar 禁用非数字键压缩，在数据输入字段中将所有字母键压更改为大写，或监视键盘或其他键输入设备以查找特定键组合。
可以获取或设置以下键：
a-z、A-Z。
CTRL。
标点符号。
数字键，同时位于键盘顶部和数字键盘上。
进入。
无法获取或设置以下键：
TAB 键。
INSERT 和 DELETE。
家。
结束。
向上页和向下页。
F1-F2。
ALT。
箭头键。
备注
有关如何检测上述任何非字符键的信息，请参阅该 KeyEventArgs 类。
| 产品 | 版本 |
|---|---|
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7 |