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

Line 6: 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 level}} for the event to trigger.
 
+
* '''<matchtext>''' - The corresponding {{mIRC|on text|matchtext}} for the event to trigger.
<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>
+
* '''<*><?><#[,#]>''' - The place, or places where the event listens, you can seperate them by comma.
 
+
** '''*''' - Any query/channel 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>Channel windows</div>
+
** '''?''' - Any query windows
 
+
** '''#''' - Any channel window
<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>Query windows</div>
+
** '''#channel[,#]''' - one or more specific channels, seperate them by comma
 
+
** '''=''' - Any DCC chat
<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>DCC Chat</div>
+
** '''!''' - Any DCC server
 
+
** '''@''' - Any custom window
<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>DCC Server</div>
+
* '''<commands>''' - The commands to be performed when the event triggers
 
 
<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>Custom window</div>
 
 
 
<span style="display: inline-block; width: 105px;">'''<commands>'''</span>The commands to be performed when the event listener's criteria is met.
 
  
 
== Examples ==
 
== Examples ==

Revision as of 06:12, 22 January 2016

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

Synopsis

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

Parameters

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

Examples

; 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

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