Medium messageSend

From TrillWiki

The medium_messageSend notification is sent when a message is typed within a chat window and should be sent over the medium on a particular connection.

Compatibility: 2.0 and higher

Contents 1 Syntax 2 Parameters 3 Return Value 4 Remarks

Syntax

callback(int window_id, char *icontrol, "medium_messageSend", message_t *data, void *userData);

Note that all Trillian functions and notifications begin with a lower-case letter, despite the Wiki requirement that all pages start with a capital letter.

Parameters

Medium messageSend utilitizes the message_t structure.

struct message_t
{
    unsigned int                struct_size;

    char                        *medium;
    int                         connection_id;

    char                        *name;
    char                        *type;
    char                        *text;

    char                        *location;

    void                        *extra_information;
    
    /* 2.0 
     */
    int                         window_id;
    unsigned int                extra_information_size;
    unsigned int                time_stamp;

    char                        *display_name;
    char                        *section;

    /* 3.0
     */
    struct capability_t         *capability_list;
    int                         text_len;
    int                         message_id;
};

medium

The medium for the window.

connection_id

The connection for the window.

name

The address of the person associated with the window.

type

The type of message. Current types are: outgoing_groupMessage, outgoing_privateMessage.

text

The text of the message to send. This is in HTML.

location

If this is a multi-person chat window, this is the name of the chat session. Otherwise this is NULL.

window_id

The window_id associated.

time_stamp

The time the message was created.

display_name

The display name for the window.

Return Value

Must return 0.

Remarks

A URL link is sent using the medium_messageSendURL notification and not this notification.

See also: medium_messageSendURL