KeyEventArgs.KeyData, KeyEventArgs.KeyCode and KeyEventArgs.KeyValue

Bosak picture Bosak · Aug 16, 2011 · Viewed 7.1k times · Source

I have question about the KeyEventArgs's KeyCode and KeyData and KeyValue. KeyCode and Keydata are Keys type, but I don't know what the difference between them is. For KeyValue, I don't know what it is -- it has an int type, does it return the char value of the pressed key?

I don't have much experience with Key events; any explanation of how they function and how to use them would be greatly appreciated.

Answer

Fredrik Mörk picture Fredrik Mörk · Aug 16, 2011

KeyCode contains data for the key that produced the KeyUp or KeyDown event. KeyData contains the combination of that key together with CTRL, SHIFT or ALT if any of those were pressed.

Example:

  • Press (and hold) CTRL. KeyDown will be raised, KeyCode will be Keys.ControlKey, KeyData will be Keys.ControlKey | Keys.Control.
  • While still holding CTRL pressed, press SHIFT. KeyDown will be raised, KeyCode will be Keys.ShiftKey and KeyData will be Keys.ShifKey | Keys.Shift | Keys.Control.

Note that KeyData and KeyCode can contain any value in the Keys enumeration (such as Keys.A, Keys.NumPad4 or Keys.Up). Note that when one of the modifier keys are pressed, it is represented by two values in KeyData (one for they key and one for the modifier value). The modifiers are also available through the Modifiers property.

KeyValue will return a numerical value representing the key, essentially an integer representing the value found in KeyCode.