ContactlistRenameRequest

From TrillWiki

The contactlistRenameRequest function forces Trillian to focus onto the given contactlist_entry_t, and put it into inline editing mode for renaming.

Compatibility: 3.0 and higher

Contents 1 Syntax 2 Parameters 3 Return Value 4 Remarks

Syntax

plugin_send(MYGUID,"contactlistRenameRequest",contactlist_entry_t *);

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

ContactlistRenameRequest utilitizes the contactlist_entry_t structure.

struct contactlist_entry_t
{
    unsigned int                struct_size;

    char                        *medium;

    int                        connection_id;

    char                        *name;
    char                        *real_name;
    char                        *status;

    /* 2.0 enhancement
     */
    char                        *section;
    char                        *uri;
    char                        *tooltip;

    int                         status_score;
    int                         status_idle;
    int                         status_block;

    struct group_entry_t        *group;
    struct menu_entry_t         *menu_entry;

    ttkCallback                 callback;
    void                        *data;

    /* 3.0 
     */
    int                         status_warned;
    int                         status_time;
    int                         status_idle_time;

    char                        *status_message;
};

medium

The medium of the contact to rename.

real_name

The contact on that medium.

Return Value

This function returns 0 if it was able to find and focus on the contact in the contactlist, or a negative value if the contact could not be found.

Remarks

None.