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

m (bot: cat fixing naming)
m (Bot: adding missing title)
 
(8 intermediate revisions by 3 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>Channel 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>Query windows</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>DCC Chat</div>
+
* '''<commands>''' - The commands to be performed when the event triggers
 
 
<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>
 
 
 
<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 ==

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]