Project

General

Profile

On OPEN » History » Version 20

Per Amundsen, 09/23/2019 04:45 PM

1 1 Per Amundsen
_Added in 1.9.0_
2
3 5 Per Amundsen
*<notextile>on <level>:OPEN:<?|=|!|*>:<matchtext>:<commands></notextile>*
4 18 Per Amundsen
*<notextile>on <level>:OPEN:<=|!|*>:<commands></notextile>*
5 8 Per Amundsen
6 2 Per Amundsen
Trigger for various events relating to the opening of a window of different types of windows.
7 1 Per Amundsen
8
Note: If you halt an [[on OPEN]] event triggered by an incoming private message, no [[on TEXT]]/[[on ACTION]] events is triggered
9
10
Note2: For private windows, [[on OPEN]] only triggers when opening a new private window from a incoming private message.
11 20 Per Amundsen
12
_For Query Chat windows, the <matchtext> parameter is required._
13
14
_For DCC Chat windows, the <matchtext> parameter is excluded, and it triggers only on successful connection._
15 11 Per Amundsen
16 7 Per Amundsen
_See also [[on CLOSE]]._
17 1 Per Amundsen
18 9 Per Amundsen
_Haltable using ^_
19
20 1 Per Amundsen
*Parameters*
21
22 17 Per Amundsen
&lt;level&gt; - The [[User Access Level]] for the event to trigger.
23 16 Per Amundsen
&lt;?|@|=|!|*&gt; - The [[Matchtarget]] to listen to.
24 15 Per Amundsen
&lt;matchtext&gt; - The [[Matchtext]] to listen to.
25
&lt;commands&lt; - The commands to be performed when the event listener's criteria is met.
26 1 Per Amundsen
27
*Example*
28
29
<pre>
30
; Print a message when a query window is opened.
31
on *:OPEN:?:*:echo -ag Opened query window for $nick
32 19 Per Amundsen
33
; Print a message when a dcc chat window is opened.
34
on *:OPEN:=:echo -ag Opened dcc chat window for $nick
35 1 Per Amundsen
</pre>