|
|
|
API Documentation for the Zeitgeist Client Library | |
|---|---|---|---|---|
| Top | Description | ||||
#include <zeitgeist.h>
ZeitgeistMonitor;
struct ZeitgeistMonitorClass;
ZeitgeistMonitor * zeitgeist_monitor_new (ZeitgeistTimeRange *time_range,
GPtrArray *event_templates);
ZeitgeistTimeRange * zeitgeist_monitor_get_time_range (ZeitgeistMonitor *self);
GPtrArray * zeitgeist_monitor_get_templates (ZeitgeistMonitor *self);
const gchar * zeitgeist_monitor_get_path (ZeitgeistMonitor *self);
A ZeitgeistMonitor listens for updates to the Zeitgeist event log matching a given set of templates and with timestamps in some predefined time range.
A monitor must be installed into the running Zeitgeist daemon by calling
zeitgeist_log_install_monitor(). The monitor will not emit any of the
::events-added or ::events-deleted signals before this.
struct ZeitgeistMonitorClass {
GObjectClass parent_class;
/*< signals >*/
void (*events_inserted) (ZeitgeistMonitor *self,
ZeitgeistTimeRange *time_range,
GPtrArray *events);
void (*events_deleted) (ZeitgeistMonitor *self,
ZeitgeistTimeRange *time_range,
GArray *event_ids);
};
ZeitgeistMonitor * zeitgeist_monitor_new (ZeitgeistTimeRange *time_range,GPtrArray *event_templates);
Create a new monitor. Before you can receive signals from the monitor you
need to install it in the running Zeitgeist daemon by calling
zeitgeist_log_install_monitor().
|
The monitor will only listen for events with timestamps within this time range. Note that it is legal for applications to insert events that are "in the past". |
|
A GPtrArray of ZeitgeistEvents. Only listen for
events that match any of these templates.
The monitor will assume ownership of the events and
the pointer array.
If you want to keep a reference for yourself you must do a
g_ptr_array_ref() on event_templates as well as reffing
the events held by it before calling this method. |
Returns : |
A reference to a newly allocated monitor. |
ZeitgeistTimeRange * zeitgeist_monitor_get_time_range (ZeitgeistMonitor *self);
GPtrArray * zeitgeist_monitor_get_templates (ZeitgeistMonitor *self);