Medium messageSendURL

From TrillWiki

The medium_messageSendURL notification is triggered when a user specifically sends a url using the URL sending toolbar button.

Compatibility: 2.0 and higher

Contents 1 Syntax 2 Parameters 3 Return Value 4 Remarks

Syntax

callback(int window_id, char *icontrol, "medium_messageSendURL", 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 messageSendURL 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 url is sent in this field in html. ie: <a href="url">url_description</a>

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

If the medium does not have a specific way to send URLs as an alternate message type, it can send this as a normal message.

See also: medium_messageSend