CalClient
GTK+ object for communication with personal calendar server.
The #CalClient object provides a nice GTK+ wrapper for the CORBA
interfaces that are used to communicate between calendar clients
and the personal calendar server in the user's Wombat daemon. The
CORBA interfaces transfer calendar components in RFC 2445 text
format; the #CalClient object automatically converts these into
#CalComponent structures that are easier to handle.
After a #CalClient object is created with cal_client_new(), it
should be asked to send a request to the personal calendar server
to load or create a calendar based on its URI. The server will
asynchronously notify the client about completion of the request,
and will return an appropriate result code; this should be noted
by the client with the cal_loaded signal.
When a client asks the server to update or delete a calendar
component from the storage, the server will do so and then notify
all the clients about the update or removal. This is the core of
the model/view split between calendar clients and the storage in
the personal calendar server. Clients should watch the obj_updated and obj_removed signals on the
CalClient objects they create so that they can be notified about
changes in the storage.
#CalComponent
Casts a #GtkObject to a #CalClient.
@obj: A GTK+ object.
@CAL_CLIENT_OPEN_SUCCESS:
@CAL_CLIENT_OPEN_ERROR:
@CAL_CLIENT_OPEN_NOT_FOUND:
@CAL_CLIENT_OPEN_METHOD_NOT_SUPPORTED:
These values describe the result of the cal_client_get_object()
function.
@CAL_CLIENT_GET_SUCCESS:
@CAL_CLIENT_GET_NOT_FOUND:
@CAL_CLIENT_GET_SYNTAX_ERROR:
@CAL_CLIENT_LOAD_NOT_LOADED:
@CAL_CLIENT_LOAD_LOADING:
@CAL_CLIENT_LOAD_LOADED:
@CAL_CLIENT_CHANGE_ADDED:
@CAL_CLIENT_CHANGE_MODIFIED:
@CAL_CLIENT_CHANGE_DELETED:
@Returns:
@client:
@str_uri:
@only_if_exists:
@Returns:
@client:
@Returns:
@client:
@Returns:
@client:
@type:
@Returns:
@client:
@type:
@Returns:
@client:
@uid:
@comp:
@Returns:
@ico:
@client:
@type:
@change_id:
@Returns:
@list:
@client:
@type:
@start:
@end:
@Returns:
@client:
@type:
@start:
@end:
@cb:
@cb_data:
@client:
@start:
@end:
@Returns:
@comp_alarms:
@client:
@uid:
@start:
@end:
@alarms:
@Returns:
@client:
@comp:
@Returns:
@ico:
@client:
@uid:
@Returns:
@calclient: the object which received the signal.
@arg1:
This signal is emitted when the calendar clients receives
notification of a calendar component's data being changed in the
personal calendar server. Graphical clients may want to get the
new version of the object and update their display, for example.
@calclient: the object which received the signal.
@arg1:
@client: Calendar client which received the notification.
@uid: Unique identifier of the calendar component that changed in the
personal calendar server's storage.
This signal is emitted when the calendar client receives
notification for a calendar component being removed from the
storage in the personal calendar server. Graphical clients may
want to delete the corresponding object from their display, for
example.
@calclient: the object which received the signal.
@arg1:
@client: Calendar client which received the notification.
@uid: Unique identifier of the calendar component that was removed
from the personal calendar server's storage.