Top | ![]() |
![]() |
![]() |
![]() |
void | query-completed | Run Last |
void | source-added | Run Last |
void | source-changed | Run Last |
void | source-enabled | Run Last |
void | source-removed | Run Last |
GcalManager is the backend of GNOME Calendar. It sets everything up, connects to the Online Accounts daemon, and manages the events and calendars.
ESource * gcal_manager_get_source (GcalManager *self
,const gchar *uid
);
Retrieve a source according to it's UID. The source is referenced for thread-safety and must be unreferenced after user.
GList *
gcal_manager_get_sources (GcalManager *self
);
Retrieve a list of the enabled sources used in the application.
GList *
gcal_manager_get_sources_connected (GcalManager *self
);
Returns a GList with every source connected on the app, whether they are enabled or not.
void gcal_manager_set_default_source (GcalManager *self
,ESource *source
);
Sets the default calendar.
icaltimezone *
gcal_manager_get_system_timezone (GcalManager *self
);
Retireves the default timezone.
void gcal_manager_set_subscriber (GcalManager *self
,ECalDataModelSubscriber *subscriber
,time_t range_start
,time_t range_end
);
Sets the subscriber
to show events between range_start
and range_end
.
void gcal_manager_set_search_subscriber (GcalManager *self
,ECalDataModelSubscriber *subscriber
,time_t range_start
,time_t range_end
);
Sets the subscriber
to show events between range_start
and range_end
.
void gcal_manager_set_query (GcalManager *self
,const gchar *query
);
Set the query terms of the ECalDataModel or clear it if NULL
is
passed
gchar * gcal_manager_query_client_data (GcalManager *self
,ESource *source
,const gchar *field
);
Queries for a specific data field of the ECalClient
void
gcal_manager_refresh (GcalManager *self
);
Forces a full refresh and synchronization of all available calendars.
gboolean gcal_manager_is_client_writable (GcalManager *self
,ESource *source
);
Retrieves whether source
is writable.
void gcal_manager_create_event (GcalManager *self
,GcalEvent *event
);
Creates event
.
void gcal_manager_update_event (GcalManager *self
,GcalEvent *event
,GcalRecurrenceModType mod
);
Saves all changes made to event
persistently.
void gcal_manager_remove_event (GcalManager *self
,GcalEvent *event
,GcalRecurrenceModType mod
);
Deletes event
.
void gcal_manager_move_event_to_source (GcalManager *self
,GcalEvent *event
,ESource *dest
);
Moves event
to dest
calendar. This is a fail-safe operation:
worst case, the user will have two duplicated events, and we
guarantee to never loose any data.
gchar * gcal_manager_add_source (GcalManager *self
,const gchar *name
,const gchar *backend
,const gchar *color
);
Add a new calendar by its URI. The calendar is enabled by default
void gcal_manager_enable_source (GcalManager *self
,ESource *source
);
Enable the given ESource.
void gcal_manager_disable_source (GcalManager *self
,ESource *source
);
Disable the given ESource.
void gcal_manager_save_source (GcalManager *self
,ESource *source
);
Commit the given ESource.
GList * gcal_manager_get_events (GcalManager *self
,icaltimetype *range_start
,icaltimetype *range_end
);
Returns a list with GcalEvent objects owned by the caller, the list and the objects. The components inside the list are owned by the caller as well.
gboolean
gcal_manager_get_loading (GcalManager *self
);
Retrieves whether self
is still loading or not. Loading is
complete when the Online Accounts client is retrieved, and all
the calendars are loaded.
GoaClient *
gcal_manager_get_goa_client (GcalManager *self
);
Retrieves the GoaClient connected by self
.
GcalEvent * gcal_manager_get_event_from_shell_search (GcalManager *self
,const gchar *uuid
);
Retrieves the GcalEvent with uuid
.
void gcal_manager_setup_shell_search (GcalManager *self
,ECalDataModelSubscriber *subscriber
);
Sets up the GNOME Shell search subscriber.
void gcal_manager_set_shell_search_query (GcalManager *self
,const gchar *query
);
Set the query terms of the ECalDataModel used in the shell search
void gcal_manager_set_shell_search_subscriber (GcalManager *self
,ECalDataModelSubscriber *subscriber
,time_t range_start
,time_t range_end
);
Subscribe subscriber
to the shell data modal at the given range.
self |
||
subscriber |
the ECalDataModelSubscriber to subscribe |
|
range_start |
the start of the range |
|
range_end |
the end of the range |
gboolean
gcal_manager_shell_search_done (GcalManager *self
);
Retrieves whether the search at self
is done or not.
GList *
gcal_manager_get_shell_search_events (GcalManager *self
);
Retrieves all the events available for GNOME Shell search.
“default-calendar”
property “default-calendar” ESource *
The default calendar.
Flags: Read / Write
“loading”
property “loading” gboolean
Whether the manager is loading or not.
Flags: Read
Default value: TRUE
“query-completed”
signalvoid user_function (GcalManager *gcalmanager, gpointer user_data)
Flags: Run Last
“source-added”
signalvoid user_function (GcalManager *gcalmanager, gpointer arg1, gboolean arg2, gpointer user_data)
Flags: Run Last
“source-changed”
signalvoid user_function (GcalManager *gcalmanager, ESource *arg1, gpointer user_data)
Flags: Run Last
“source-enabled”
signalvoid user_function (GcalManager *gcalmanager, ESource *arg1, gboolean arg2, gpointer user_data)
Flags: Run Last
“source-removed”
signalvoid user_function (GcalManager *gcalmanager, gpointer arg1, gpointer user_data)
Flags: Run Last