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.
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.
Casts a #GtkObject to a #CalClient.
@obj: A GTK+ object.
These values describe the status of a calendar load or create
request. After asking a calendar factory to load or create a
calendar, the provided listener will get notification about the
result in asynchronous fashion. Such notification is represented
by one of these enumeration values. For values other than
#CAL_CLIENT_LOAD_SUCCESS, the #CalClient object will not accept
any other operations on the calendar and it should just be
destroyed.
@CAL_CLIENT_LOAD_SUCCESS: Indicates a successful load or create
operation; the corresponding calendar is ready for use.
@CAL_CLIENT_LOAD_ERROR: Indicates an error while loading or creating
the calendar.
@CAL_CLIENT_LOAD_IN_USE: Indicates that a create request failed
because the specified calendar was already being used by another
client.
@CAL_CLIENT_LOAD_METHOD_NOT_SUPPORTED: Indicates an error due to
trying to load a calendar for which a backend type is not present.
These values describe the result of the cal_client_get_object()
function.
@CAL_CLIENT_GET_SUCCESS: Indicates a successful get operation.
@CAL_CLIENT_GET_NOT_FOUND: Indicates that the requested object was
not found.
@CAL_CLIENT_GET_SYNTAX_ERROR: Indicates a syntax error when parsing
the requested object. This could indicate a bug in the calendar
client libraries or in the Wombat server.
@Returns:
@client:
@str_uri:
@Returns:
@client:
@str_uri:
@Returns:
@client:
@type:
@Returns:
@client:
@uid:
@comp:
@Returns:
@ico:
@client:
@type:
@start:
@end:
@Returns:
@client:
@type:
@start:
@end:
@cb:
@cb_data:
@client:
@pilot_id:
@uid:
@Returns:
@client:
@uid:
@pilot_id:
@pilot_status:
@client:
@type:
@Returns:
@client:
@start:
@end:
@Returns:
@client:
@uid:
@start:
@end:
@alarms:
@Returns:
@client:
@comp:
@Returns:
@ico:
@client:
@uid:
@Returns:
This signal is emitted some time after the calendar clients sends
a load or create request to the personal calendar server. The
server will notify the client asynchronously of the completion of
the request. The @status parameter indicates the status of the
request.
@calclient: the object which received the signal.
@arg1:
@client: Calendar client which received the notification.
@status: Status of the request. See the description of
#CalClientLoadStatus for more details.
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.