From WikiChip
Difference between revisions of "mirc/on events/on chat"
< mirc‎ | on events

m (bot: cat fixing naming)
m (Bot: adding missing title)
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
The '''ON Chat''' event, much like the [[On serv - mIRC|ON Serv]] event, is triggered when a message is sent via a [[DCC Chat - mIRC|DCC Chat]] window.
+
{{mirc title|On Chat - Events}}
 +
The '''ON Chat''' event, much like the [[On serv - mIRC|ON Serv]] event, is triggered when a message is sent via a {{mIRC|/dcc|dcc chat}} window.
  
 
== Synopsis ==
 
== Synopsis ==
Line 5: Line 6:
  
 
== Parameters ==
 
== Parameters ==
−
<span style="display: inline-block; width: 105px;">'''<level>'''</span>The level for the event to trigger.
+
* '''<level>''' - The corresponding {{mIRC|access levels}} for the event to trigger.
  
−
<span style="display: inline-block; width: 105px;">'''<matchtext>'''</span>The text that to be matched. Much like the [[On text - mIRC|ON TEXT]] event, this can be any combination of text letters, numbers, and [[wildcards]].
+
* '''<matchtext>''' - The corresponding {{mIRC|on text|matchtext}} for the 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.
+
* '''<commands>''' - The commands to be performed when the event listener's criteria is met.
 +
 
 +
== {{mIRC|Local identifiers}} ==
 +
 
 +
You can use {{mIRC|identifiers/{{=}}$nick|{{=}}$nick}} to refer to the dcc chat window, rather than a query window.
  
 
== Examples ==
 
== Examples ==
Line 15: Line 20:
 
; command !time and then relays back to them the current time
 
; command !time and then relays back to them the current time
  
−
ON *:CHAT:!time:msg =$nick The current time is: hh:nntt</source>
+
ON *:CHAT:!time:msg =$nick The current time is: $time(hh:nntt)</source>
  
−
In the above example, the '''msg''' is not simply followed by the '''{{mIRC|$nick}}''' identifier. Instead, the {{mIRC|{{=}}$nick identifier|{{=}}$nick}} identifier has been used. This special identifier tells mIRC that the event should not simply send a private message to the user, but rather it should message the user's DCC Chat window, if there is one.
+
In the above example, the message is sent to the dcc chat window
  
 
== Compatibility ==
 
== Compatibility ==

Latest revision as of 19:12, 15 June 2017

Commands & Identifiers
Basics
Events
Matching Tools
Data Storage
Control Structures
GUI Scripting
Sockets
Advanced Scripting
Additional Resources
Security
Other
v · d · e

The ON Chat event, much like the ON Serv event, is triggered when a message is sent via a dcc chat window.

Synopsis[edit]

ON <level>:CHAT:<matchtext>:<commands>

Parameters[edit]

  • <level> - The corresponding access levels for the event to trigger.
  • <matchtext> - The corresponding matchtext for the event to trigger.
  • <commands> - The commands to be performed when the event listener's criteria is met.

Local identifiers[edit]

You can use =$nick to refer to the dcc chat window, rather than a query window.

Examples[edit]

; This event waits for any user on a DCC Chat to use the
; command !time and then relays back to them the current time
 
ON *:CHAT:!time:msg =$nick The current time is: $time(hh:nntt)

In the above example, the message is sent to the dcc chat window

Compatibility[edit]

Added: mIRC v3.8
Added on: 25 Nov 1995
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.


See Also[edit]

v · d · e mIRC on event list

A on Action, on Active, on Agent, on Appactive

B on Ban

C on Char, on Chat, on Chatclose, on Chatopen, on Close, on Connect, on Connectfail, on Ctcpreply

D on Dccserver, on Dehelp, on Deop, on Deowner, on Devoice, on Dialog, on Disconnect, on Dns

E on Error, on Exit

F on Filercvd, on Filesent

G on Getfail

H on Help, on Hotlink

I on Input, on Invite

J on Join

K on Keydown, on Keyup, on Kick

L on Load, on Logon

M on Midiend, on Mode, on Mp3end

N on Nick, on Nosound, on Notice, on Notify

O on Op, on Open, on Owner

P on Parseline, on Part, on Ping, on Playend, on Pong

Q on Queryclose, on Queryopen, on Quit

R on Rawmode

S on Sendfail, on Serv, on Servclose, on Servermode, on Serverop, on Servopen, on Signal, on Snotice,  on Sockclose, on Socklisten, on Sockopen, on Sockread, on Sockwrite, on Start

T on Text, on Topic

U on Udpread, on Udpwrite, on Unban, on Unload, on Unotify, on Usermode

V on Vcmd, on Voice

W on Wallops, on Waveend

Retrieved from "https://en.wikichip.org/w/index.php?title=mirc/on_events/on_chat&oldid=44951"