From WikiChip
On Input - Events - mIRC
< mirc‎ | on events
Revision as of 06:42, 6 February 2024 by KindOne (talk | contribs) (Parameters: Link access levels)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

The ON INPUT event triggers when text is entered into an mIRC editbox, then followed by an enter-key press.

Synopsis[edit]

ON <level>:INPUT:<*#?=!@>:<commands>

Parameters[edit]

<level>The corresponding access levels for the event to trigger.

<*#?=!@>The window type that this event should monitor.

*Any window
#Any channel, or specific channel name(s)
?Query windows
=DCC Chat windows
!Fserve windows
@Custom windows

<commands>The commands to be performed when the event listener's criteria is met.

Examples[edit]

If ^scripts is entered into an editbox, echo the total amount of loaded scripts to the active window:

ON *:INPUT:*: {
  if ($1 == ^scripts) {
    echo -a There are $script(0) script(s) loaded.
    haltdef
  }
}

The results would look something like this:

There are 9 total script(s) loaded.

The example above makes use of the /haltdef command, which prevents mIRC from performing the default operation for this event. If there were no /haltdef there, mIRC would carry out the first command which was to echo the details to the active window, but then it would also either send the message to the active chat, or channel, or provide an error stating you are not currently on a channel.

Compatibility[edit]

Added: mIRC v5.0
Added on: 02 Apr 1997
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.


See Also[edit]