Project

General

Profile

On OPEN » History » Version 24

Per Amundsen, 04/01/2022 03:33 AM

1 1 Per Amundsen
_Added in 1.9.0_
2
3 24 Per Amundsen
*<notextile>on <level>:OPEN:<?|=|*>:<matchtext>:<commands></notextile>*
4
*<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 22 Per Amundsen
For private chat windows, [[on OPEN]] only triggers when opening a new private window from a incoming private message.
11 20 Per Amundsen
12 22 Per Amundsen
For private chat windows, the <matchtext> parameter is required.
13 20 Per Amundsen
14 22 Per Amundsen
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 23 Per Amundsen
; Print a message when a dcc chat window is established.
34 19 Per Amundsen
on *:OPEN:=:echo -ag Opened dcc chat window for $nick
35 1 Per Amundsen
</pre>