re_handled


Description:

public signal void re_handled (Channel channel, int64 user_action_time, HandleChannelsContext context)

Emitted when the channel created using self has been "re-handled".

This means that a Telepathy client has made another request for a matching channel using an "ensure" API like ensure_channel_async, while the channel still exists. Instead of creating a new channel, the channel dispatcher notifies the existing handler of channel, resulting in this signal.

Most GUI handlers should respond to this signal by checking user_action_time, and if appropriate, moving to the foreground.

context can be used to obtain extensible information about the channel via get_handler_info, and any similar methods that are added in future. It is not valid for the receiver of this signal to call accept, delay or fail.

Parameters:

channel

the Channel being re-handled

user_action_time

the time at which user action occurred, or one of the special values USER_ACTION_TIME_NOT_USER_ACTION or TP_USER_ACTION_TIME_CURRENT_TIME; see user_action_time

context

a HandleChannelsContext representing the context of the HandleChannels call.