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

(Parameters)
m (Bot: adding missing title)
 
(17 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.
<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: 105px; margin-right: 25px; width: 60px;">'''*'''</span>Any window</div>
+
** '''*''' - Any query/channel window
 
+
** '''?''' - Any query windows
<div style="background-color: rgba(0,0,0,.06); display: block;"><span style="border-right: 1px dashed rgba(0,0,0,.15); display: inline-block; margin-left: 105px; margin-right: 25px; width: 60px;">'''?'''</span>Query windows</div>
+
** '''#''' - Any channel window
 
+
** '''=''' - Any DCC chat
<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: 105px; margin-right: 25px; width: 60px;">'''#'''</span>Any channel</div>
+
** '''!''' - Any DCC server
 
+
** '''@''' - Any custom window
<div style="background-color: rgba(0,0,0,.06); display: block;"><span style="border-right: 1px dashed rgba(0,0,0,.15); display: inline-block; margin-left: 105px; margin-right: 25px; width: 60px;">'''[,#]'''</span>Specific channel names</div>
+
* '''<commands>''' - The commands to be performed when the event triggers
 
 
<span style="display: inline-block; width: 105px;">'''<commands>'''</span>The commands to be performed when the event listener's criteria is met.
 
  
 
== Examples ==
 
== Examples ==
Line 26: Line 24:
  
 
== 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]