OnEvent_ChatWndSendMessage

The OnEvent_ChatWndSendMessage event is fired every time the current user sends a message in a chat window.

Syntax

[string] OnEvent_ChatWndSendMessage(
    [object] ChatWnd,
    [string] Message
);

Parameters

ChatWnd

[object] Reference to the ChatWnd object attached to the chat generating the event.

Message

[string] Message that's being sent to the chat's participants. Emoticons present in the message are converted back to their text code before the event is generated (when possible) and will be re-parsed before the message is actually sent to the server.

Return Value

A string containing the message to be sent instead of Message. If you do not want to modify the message, simply return Message without changing it. No size restriction applies to the new message except for the maximum size allowed by Messenger. If the event handler returns an empty string, the message is ignored and not sent to the server.

Remarks

This event is generated after Messenger Plus! checks the message for quick texts but before searching for commands or tags. The only exception is for the "/text" command, which, if specified, forces the message to be sent without any kind of modification, including those made by scripts.

Event Information

See Also

Messenger Events, ChatWnd Object.