View source for On open

The on OPEN events trigger for various events relating to the opening of a window.
 on <level>:OPEN:<?|@|=|!|*>:<matchtext>:<commands>


The matchtext can be a [[If-Then-Else#The_Operators|wildcard]] match or even a [[Regular_Expression|regular expression]]. 
To use regular expressions as matchtext, you need the [[Access_Levels|$-Prefix]].

Read [[Access_Levels|access levels]] to get more info about the <level> field.

The location where this event occurrs can be either a channel (#), a query (?), a DCC-window (=) or a fileserver-window (!) or everything (*).

'''Note''' that in the case of dcc sessions, it is trigger when a dcc connection has opened.

== Example ==
 on *:Open:?:*: {
  [[echo]] -a $nick has just opened a query window with you!
 }
This example reacts on every opening query and echos it to the active window.



 on ^*:Open:?:*: {
  [[if]] ([[$nick]] == idiot) {
   [[halt]]
  }
 }
This example also reacts on every opening query but ''before'' the window has opened, checks if the nick is ''idiot'' and if it is, halts the opening.

== See Also ==
* [[On_close|On close event]] to trigger on the closing of a window.

[[Category:Events]]