Editing mirc/on events/on keyup

{{mirc title|On Keyup - Events}}
The '''ON KEYUP''' event is triggered when a key has been pressed, but subsequently released, inside of a custom {{mirc|custom windows|@window}}.

This event fills the following identifiers:
<div style="background-color: rgba(0,0,0,.03); display: block;"><span style="border-right: 1px dashed rgba(0,0,0,.15); display: inline-block; margin-left: 35px; margin-right: 10px; width: 70px;">'''{{mIRC|$keyval}}'''</span>The [[unicode character|unicode character]] value of the key being released</div>

<div style="background-color: rgba(0,0,0,.03); display: block;"><span style="border-right: 1px dashed rgba(0,0,0,.15); display: inline-block; margin-left: 35px; margin-right: 10px; width: 70px;">'''{{mIRC|$keychar}}'''</span>The actual character released</div>

<div style="background-color: rgba(0,0,0,.03); display: block; margin-bottom: 10px;"><span style="border-right: 1px dashed rgba(0,0,0,.15); display: inline-block; margin-left: 35px; margin-right: 10px; width: 70px;">'''{{mIRC|$keyrpt}}'''</span>During this '''ON KEYUP''' event, the '''$keyrpt''' identifier always returns ''$true''</div>

== Synopsis ==
<pre>ON <level>:KEYUP:<@>:<key,...,keyN>:<commands></pre>

== Parameters ==
<span style="display: inline-block; width: 105px;">'''<level>'''</span>The corresponding {{mIRC|access levels}} for the event to trigger.

<span style="display: inline-block; width: 105px;">'''<@>'''</span>The {{mirc|custom windows|custom window}} where this event should listen. Can be '''@''' for all windows.

<span style="display: inline-block; width: 105px;">'''<commands>'''</span>The specific key, or keys to listen for. Can specify multiple keys, such as:
<source lang="mIRC">ON *:KEYUP:@myWindow:38,42,55,78:echo -a $keyval</source>

== Example ==
Create an alias that launches a custom, {{mirc|picture windows|picture window}} which listens for key releases and displays the key value released, and the key character released:
<source lang="mIRC">alias keyUpTest {
  window -p $+ $iif($window(@myWindow),ra) @myWindow 550 300 250 83
}
ON *:KEYUP:@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)
}</source>

The following command can now be typed into any mIRC command prompt:
<pre>/keyUpTest</pre>

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

[[File:On keyup event - mIRC (fixed).png|This screenshot depicts the On Keyup event in mIRC.]]

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

== Compatibility ==
{{mIRC compatibility|5.8}}

== See Also ==
* {{mirc|custom windows}}
* {{mIRC|/drawtext}}
* {{mirc|on keydown}}
* {{mIRC|$keyval}}
* {{mIRC|$keychar}}
* {{mIRC|$keyrpt}}
{{mIRC on event list}}

[[Category:mIRC on events|keyup]]