From WikiChip
Difference between revisions of "mirc/on events/on active"
< mirc‎ | on events

m (Bot: adding missing title)
m (Bot: adding missing title)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{mirc title|On Active}}
+
{{mirc title|On Active - Events}}
 +
The '''ON ACTIVE''' event monitors when a certain window, or window type, is activated or has had its active status changed.
 +
 
 +
== Synopsis ==
 +
<pre>ON <level>:ACTIVE:<*#?=!@>:<commands></pre>
 +
 
 +
== Parameters ==
 +
 
 +
* '''<level>''' - The corresponding {{mIRC|access levels}} for the event to trigger.
 +
* '''<*><?><#[,#]>''' - The place, or places where the event listens, you can specify specific name of window, seperate them by comma.
 +
** '''*''' - Any query/channel window
 +
** '''?''' - Any query windows
 +
** '''#''' - Any channel window
 +
** '''=''' - Any DCC chat
 +
** '''!''' - Any DCC server
 +
** '''@''' - Any custom window
 +
* '''<commands>''' - The commands to be performed when the event triggers
 +
 
 +
== Examples ==
 +
<source lang="mIRC">; Listen for any window becoming active,
 +
; then display information about that window and the previous active window
 +
 
 +
ON *:ACTIVE:*:echo -a * $active is now active, took over for $lactive</source>
 +
 
 +
== Compatibility ==
 +
{{mIRC compatibility|5.9}}
 +
 
 +
== See Also ==
 +
* [[List of on events - mIRC|mIRC Events]]
 +
* [[On appactive - mIRC|ON APPACTIVE]]
 +
* {{mIRC|$active}}
 +
* {{mIRC|$activecid}}
 +
* {{mIRC|$activewid}}
 +
* {{mIRC|$lactive}}
 +
* {{mIRC|$lactivecid}}
 +
* {{mIRC|$lactivewid}}
 +
{{mIRC on event list}}
 +
 
 +
[[Category:mIRC on events|active]]

Latest revision as of 20:11, 15 June 2017

The ON ACTIVE event monitors when a certain window, or window type, is activated or has had its active status changed.

Synopsis[edit]

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

Parameters[edit]

  • <level> - The corresponding access levels for the event to trigger.
  • <*><?><#[,#]> - The place, or places where the event listens, you can specify specific name of window, seperate them by comma.
    • * - Any query/channel window
    • ? - Any query windows
    • # - Any channel window
    • = - Any DCC chat
    • ! - Any DCC server
    • @ - Any custom window
  • <commands> - The commands to be performed when the event triggers

Examples[edit]

; Listen for any window becoming active,
; then display information about that window and the previous active window
 
ON *:ACTIVE:*:echo -a * $active is now active, took over for $lactive

Compatibility[edit]

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


See Also[edit]