From WikiChip
On Keydown - Events - mIRC
< mirc‎ | on events

The ON KEYDOWN event is triggered when a key is pressed down inside of a custom @window.

This event fills the following identifiers:

$keyvalThe unicode character value of the key pressed
$keycharThe actual character pressed
$keyrptIf the key is being held down/repeating


ON <level>:KEYDOWN:<@>:<key,...,keyN>:<commands>


<level>The level for the event to trigger.

<@>The custom window where this event should listen. Can be @ for all windows.

<commands>The specific key, or keys to listen for. Can specify multiple keys, such as:

ON *:KEYDOWN:@myWindow:38,42,55,78:echo -a $keyval


Create an alias that launches a custom, picture window which listens for key presses and displays the key value pressed, the key character pressed, and if it is repeating:

alias keyDownTest {
  window -p $+ $iif($window(@myWindow),ra) @myWindow 550 300 250 105
ON *:KEYDOWN:@myWindow:*: {
  clear @myWindow
  drawtext @myWindow 1 3 3 Key value: $iif($keyval,$v1,NA)
  drawtext @myWindow 1 3 25 Key character: $iif($keychar,$v1,NA)
  drawtext @myWindow 1 3 47 @myWindow Repeating: $keyrpt

The following command can now be typed into any mIRC command prompt:


Below is an image reflecting what this example will look like:

This screenshot shows an example of the ON KEYDOWN event custom example.

Note that this makes use of a picture window, as well as the drawtext command. These types of windows and their tools can be very powerful in creating some amazing graphical layouts, as well as mIRC games.


Added: mIRC v5.8
Added on: 05 Sep 2000
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.

See Also[edit]