Player.KeyDown event

Article
06/20/2023

[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The KeyDown event occurs when a key is pressed.

Syntax

Player.KeyDown(
  nKeyCode,
  nShiftState
)

Parameters

nKeyCode: Number (int) specifying which physical key is pressed. For possible values, see the Remarks section.
nShiftState: Number (int) specifying a bitfield with the least significant bits corresponding to the SHIFT key (bit 0), the CTRL key (bit 1), and the ALT key (bit 2). These bits correspond to the values 1, 2, and 4, respectively. The shift argument indicates the state of these keys. Some, all, or none of the bits can be set, indicating that some, all, or none of the keys are pressed.

Return value

This event does not return a value.

Remarks

The nKeyCode argument specifies a physical key. The following tables show the possible values for the major keys on a standard keyboard.

Values for the main keys.

Key	Value
A-Z	65-90
0-9	48-56
F1-F12	112-123
ESC	27
TAB	9
CAPS LOCK	20
SHIFT (left or right)	16
CTRL (left or right)	17
ALT (left or right)	18
SPACE	32
BACKSPACE	8
ENTER	13
Windows logo key, left	91
Windows logo key, right	92
Application key	93

Values for the number pad keys.

Key	Value
0-9	96-105
NUM LOCK	144
DIVIDE (/)	111
MULTIPLY (*)	106
SUBTRACT (-)	109
ADD (+)	107
SEPARATOR (Enter)	108
DECIMAL (.)	110

Values for the navigation keys.

Key	Value
INSERT	45
DELETE	46
HOME	36
END	35
PAGE UP	33
PAGE DOWN	34
UP ARROW	38
DOWN ARROW	40
LEFT ARROW	37
RIGHT ARROW	39

The value of event parameters is specified by Windows Media Player, and can be accessed or passed to a method in an imported JScript file using the parameter name given. This parameter name must be typed exactly as shown, including capitalization.

Windows Media Player 10 Mobile: This event is not supported.

Requirements

Requirement	Value
Version	Windows Media Player 9 Series or later.
DLL	Wmp.dll