Editing mirc/on events/on open

{{mirc title|On Open - Events}}
The '''ON OPEN''' event triggers within mIRC when a specific window type is opened, either locally, through server interaction, or due to a scripted circumstance. This event can be used to trigger scripted situations for actions to perform when a certain window is opened.

Much like the [[On close - mIRC|ON CLOSE]] event, the '''ON OPEN''' event triggers the {{mIRC|$target}} identifier, and fills it with the window name related to the event. During the '''ON OPEN''' events, {{mIRC|$target}} now refers to the window the event is dealing with.

== Synopsis ==
<pre>ON <level>:OPEN:<?|@|=|!|*>:<matchtext>:<commands></pre>

== Parameters ==
<span style="display: inline-block; width: 105px;">'''<level>'''</span>The corresponding {{mIRC|access levels}} for the event to trigger.

<span style="display: inline-block; width: 105px;">'''<?|@|=|!|*>'''</span>The window type that the event should trigger for:

<div style="background-color: rgba(0,0,0,.03); display: block;"><span style="border-right: 1px dashed rgba(0,0,0,.15); display: inline-block; margin-left: 105px; margin-right: 25px; width: 30px;">'''?'''</span>Private messages/query windows.</div>

<div style="background-color: rgba(0,0,0,.06); display: block;"><span style="border-right: 1px dashed rgba(0,0,0,.15); display: inline-block; margin-left: 105px; margin-right: 25px; width: 30px;">'''@'''</span>[[Custom Windows - mIRC|Custom @windows]]</div>

<div style="background-color: rgba(0,0,0,.03); display: block;"><span style="border-right: 1px dashed rgba(0,0,0,.15); display: inline-block; margin-left: 105px; margin-right: 25px; width: 30px;">'''='''</span>DCC Chat windows.</div>

<div style="background-color: rgba(0,0,0,.06); display: block;"><span style="border-right: 1px dashed rgba(0,0,0,.15); display: inline-block; margin-left: 105px; margin-right: 25px; width: 30px;">'''!'''</span>DCC Fileserv windows.</div>

<div style="background-color: rgba(0,0,0,.03); display: block;"><span style="border-right: 1px dashed rgba(0,0,0,.15); display: inline-block; margin-left: 105px; margin-right: 25px; width: 30px;">'''*'''</span>All window types.</div>

<span style="display: inline-block; width: 105px;">'''<matchtext>'''</span>The text that should be matched. Can be a [[wildcard]]. Specifically for this event, this text will most-likely be from a private message query window opening up. The reason is that this will allow interaction with the text, during the event of a query window opening, immediately, rather than waiting for an [[On text - mIRC|ON TEXT]] event to trigger.

<span style="display: inline-block; width: 105px;">'''<commands>'''</span>The commands to be performed when the event listener's criteria is met.

== Examples ==
<source lang="mIRC">; When a query window opens, recognize if
; the user has typed the !yourserver command, which will
; relay to the user the current server for the mIRC client

ON *:OPEN:?:!yourserver:msg $nick Current IRC Server: $server $+ .</source>

== Compatibility ==
{{mIRC compatibility|5.3}}

== See Also ==
[[On close - mIRC|ON CLOSE]]
{{mIRC on event list}}

[[Category:mIRC on events|open]]