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

(Created On active event - mIRC)
 
m (Bot: adding missing title)
 
(19 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 +
{{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.
 
The '''ON ACTIVE''' event monitors when a certain window, or window type, is activated or has had its active status changed.
  
Line 5: Line 6:
  
 
== Parameters ==
 
== Parameters ==
<span style="display: inline-block; width: 105px;">'''<level>'''</span>The level for the event to trigger.
 
  
<span style="display: inline-block; width: 105px;">'''<*#?=!@>'''</span>The place, or places where the event listens.
+
* '''<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.
<span style="display: inline-block; width: 105px;">'''<commands>'''</span>The commands to be performed when the event listener's criteria is met.
+
** '''*''' - 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 ==
 
== Examples ==
 
<source lang="mIRC">; Listen for any window becoming active,
 
<source lang="mIRC">; Listen for any window becoming active,
 
; then display information about that window and the previous active window
 
; then display information about that window and the previous active window
 +
 
ON *:ACTIVE:*:echo -a * $active is now active, took over for $lactive</source>
 
ON *:ACTIVE:*:echo -a * $active is now active, took over for $lactive</source>
 
  
 
== Compatibility ==
 
== Compatibility ==
Added: mIRC v5.9
+
{{mIRC compatibility|5.9}}
 
 
Added On: 26/04/2001
 
  
 
== See Also ==
 
== See Also ==
 
* [[List of on events - mIRC|mIRC Events]]
 
* [[List of on events - mIRC|mIRC Events]]
 
* [[On appactive - mIRC|ON APPACTIVE]]
 
* [[On appactive - mIRC|ON APPACTIVE]]
* [[$active identifier - mIRC|$active]]
+
* {{mIRC|$active}}
* [[$activecid identifier - mIRC|$activecid]]
+
* {{mIRC|$activecid}}
* [[$activewid identifier - mIRC|$activewid]]
+
* {{mIRC|$activewid}}
* [[$lactive identifier - mIRC|$lactive]]
+
* {{mIRC|$lactive}}
* [[$lactivecid identifier - mIRC|$lactivecid]]
+
* {{mIRC|$lactivecid}}
* [[$lactivewid identifier - mIRC|$lactivewid]]
+
* {{mIRC|$lactivewid}}
 +
{{mIRC on event list}}
  
[[Category:mIRC on events]]
+
[[Category:mIRC on events|active]]

Latest revision as of 19: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]