Medium windowOpen

From TrillWiki

The medium_windowOpen notification is sent whenever a message window is opened for that medium.

Compatibility: 2.0 and higher

Contents 1 Syntax 2 Parameters 3 Return Value 4 Remarks

Syntax

callback(int window_id, char *icontrol, "medium_windowOpen", 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 windowOpen 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 window that is opened, current types are: open_status, open_private, open_group and open.

location

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

window_id

The window_id associated.

display_name

The display_name for the window.

Return Value

Must return 0.

Remarks

None.

See also: medium_windowClose