On OPEN » History » Version 23
  Per Amundsen, 09/23/2019 04:46 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 | 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 | <level> - The [[User Access Level]] for the event to trigger. | 
| 23 | 16 | Per Amundsen | <?|@|=|!|*> - The [[Matchtarget]] to listen to. | 
| 24 | 15 | Per Amundsen | <matchtext> - The [[Matchtext]] to listen to. | 
| 25 | <commands< - 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> |