Project

General

Profile

On OPEN » History » Revision 21

Revision 20 (Per Amundsen, 09/23/2019 04:45 PM) → Revision 21/24 (Per Amundsen, 09/23/2019 04:45 PM)

_Added in 1.9.0_ 

 *<notextile>on <level>:OPEN:<?|=|!|*>:<matchtext>:<commands></notextile>* 
 *<notextile>on <level>:OPEN:<=|!|*>:<commands></notextile>* 

 Trigger for various events relating to the opening of a window of different types of windows. 

 Note: If you halt an [[on OPEN]] event triggered by an incoming private message, no [[on TEXT]]/[[on ACTION]] events is triggered 

 Note2: For private windows, [[on OPEN]] only triggers when opening a new private window from a incoming private message. 

 For _For Query Chat windows, the <matchtext> parameter is required. required._ 

 For _For DCC Chat windows, the <matchtext> parameter is excluded, and it triggers only on successful connection. connection._ 

 _See also [[on CLOSE]]._ 

 _Haltable using ^_ 

 *Parameters* 

 &lt;level&gt; - The [[User Access Level]] for the event to trigger. 
 &lt;?|@|=|!|*&gt; - The [[Matchtarget]] to listen to. 
 &lt;matchtext&gt; - The [[Matchtext]] to listen to. 
 &lt;commands&lt; - The commands to be performed when the event listener's criteria is met. 

 *Example* 

 <pre> 
 ; Print a message when a query window is opened. 
 on *:OPEN:?:*:echo -ag Opened query window for $nick 

 ; Print a message when a dcc chat window is opened. 
 on *:OPEN:=:echo -ag Opened dcc chat window for $nick 
 </pre>