System.Windows.Forms.KeyPressEventArgs.KeyChar Property

Gets or sets the character corresponding to the key pressed.

Syntax

public char KeyChar { set; get; }

Value

Documentation for this section has not yet been entered.

Remarks

Use the KeyPressEventArgs.KeyChar property to sample keystrokes at run time and to modify keystrokes under special run-time circumstances. For example, you can use KeyPressEventArgs.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.

  • 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:

  • The TAB key.

  • INSERT and DELETE.

  • HOME.

  • END.

  • PAGE UP and PAGE DOWN.

  • F1-F2.

  • ALT.

  • Arrow keys.

Note:

For information about how to detect any of the non-character keys mentioned above, see the System.Windows.Forms.KeyEventArgs class.

Requirements

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0