refresh_add_timeout
Description:
This is a simple way to schedule a periodic data source refresh.
Adds a timeout SocketSource to context
and handles all the bookkeeping
if this's refresh enabled
state or its refresh interval_minutes value changes.
The callback
is expected to dispatch an asynchronous job to connect to and fetch updates from a remote server.
The returned ID can be passed to refresh_remove_timeout
to remove the timeout from context
. Note the ID is a private handle and cannot be passed to
remove.
Parameters:
this |
an Source |
context |
a MainContext, or |
callback |
function to call on each timeout |
notify |
function to call when the timeout is removed, or |
user_data |
data to pass to |
Returns:
a refresh timeout ID |