path: root/doc/devel/calendar/cal-client/tmpl/cal-client.sgml

<!-- ##### SECTION Title ##### -->
CalClient

<!-- ##### SECTION Short_Description ##### -->
GTK+ object for communication with personal calendar server.

<!-- ##### SECTION Long_Description ##### -->
  <para>
    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.
  </para>

  <para>
    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 <link
    linkend="CalClient--cal-loaded">cal_loaded</link> signal.
  </para>

  <para>
    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 <link
    linkend="calclient-obj-updated">obj_updated</link> and <link
    linkend="calclient-obj-removed">obj_removed</link> signals on the
    CalClient objects they create so that they can be notified about
    changes in the storage.
  </para>

<!-- ##### SECTION See_Also ##### -->
  <para>
    #CalComponent
  </para>

<!-- ##### MACRO CAL_CLIENT ##### -->
  <para>
    Casts a #GtkObject to a #CalClient.
  </para>

@obj: A GTK+ object.


<!-- ##### ENUM CalClientOpenStatus ##### -->
<para>

</para>

@CAL_CLIENT_OPEN_SUCCESS: 
@CAL_CLIENT_OPEN_ERROR: 
@CAL_CLIENT_OPEN_NOT_FOUND: 
@CAL_CLIENT_OPEN_METHOD_NOT_SUPPORTED: 

<!-- ##### ENUM CalClientGetStatus ##### -->
  <para>
    These values describe the result of the cal_client_get_object()
    function.
  </para>

@CAL_CLIENT_GET_SUCCESS: 
@CAL_CLIENT_GET_NOT_FOUND: 
@CAL_CLIENT_GET_SYNTAX_ERROR: 

<!-- ##### ENUM CalClientLoadState ##### -->
<para>

</para>

@CAL_CLIENT_LOAD_NOT_LOADED: 
@CAL_CLIENT_LOAD_LOADING: 
@CAL_CLIENT_LOAD_LOADED: 

<!-- ##### ENUM CalClientChangeType ##### -->
<para>

</para>

@CAL_CLIENT_CHANGE_ADDED: 
@CAL_CLIENT_CHANGE_MODIFIED: 
@CAL_CLIENT_CHANGE_DELETED: 

<!-- ##### FUNCTION cal_client_new ##### -->
<para>

</para>

@Returns: 


<!-- ##### FUNCTION cal_client_open_calendar ##### -->
<para>

</para>

@client: 
@str_uri: 
@only_if_exists: 
@Returns: 


<!-- ##### FUNCTION cal_client_get_load_state ##### -->
<para>

</para>

@client: 
@Returns: 


<!-- ##### FUNCTION cal_client_get_uri ##### -->
<para>

</para>

@client: 
@Returns: 


<!-- ##### FUNCTION cal_client_get_n_objects ##### -->
<para>

</para>

@client: 
@type: 
@Returns: 


<!-- ##### FUNCTION cal_client_get_uids ##### -->
<para>

</para>

@client: 
@type: 
@Returns: 


<!-- ##### FUNCTION cal_client_get_object ##### -->
<para>

</para>

@client: 
@uid: 
@comp: 
@Returns: 
<!-- # Unused Parameters # -->
@ico: 


<!-- ##### FUNCTION cal_client_get_changes ##### -->
<para>

</para>

@client: 
@type: 
@change_id: 
@Returns: 


<!-- ##### FUNCTION cal_client_change_list_free ##### -->
<para>

</para>

@list: 


<!-- ##### FUNCTION cal_client_get_objects_in_range ##### -->
<para>

</para>

@client: 
@type: 
@start: 
@end: 
@Returns: 


<!-- ##### FUNCTION cal_client_generate_instances ##### -->
<para>

</para>

@client: 
@type: 
@start: 
@end: 
@cb: 
@cb_data: 


<!-- ##### FUNCTION cal_client_get_alarms_in_range ##### -->
<para>

</para>

@client: 
@start: 
@end: 
@Returns: 


<!-- ##### FUNCTION cal_client_free_alarms ##### -->
<para>

</para>

@comp_alarms: 


<!-- ##### FUNCTION cal_client_get_alarms_for_object ##### -->
<para>

</para>

@client: 
@uid: 
@start: 
@end: 
@alarms: 
@Returns: 


<!-- ##### FUNCTION cal_client_update_object ##### -->
<para>

</para>

@client: 
@comp: 
@Returns: 
<!-- # Unused Parameters # -->
@ico: 


<!-- ##### FUNCTION cal_client_remove_object ##### -->
<para>

</para>

@client: 
@uid: 
@Returns: 


<!-- ##### FUNCTION cal_client_get_query ##### -->
<para>

</para>

@client: 
@sexp: 
@Returns: 


<!-- ##### SIGNAL CalClient::cal-opened ##### -->
<para>

</para>

@calclient: the object which received the signal.
@arg1: 

<!-- ##### SIGNAL CalClient::obj-updated ##### -->
  <para>
    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.
  </para>

@calclient: the object which received the signal.
@arg1: 
<!-- # Unused Parameters # -->
@client: Calendar client which received the notification.
@uid: Unique identifier of the calendar component that changed in the
  personal calendar server's storage.

<!-- ##### SIGNAL CalClient::obj-removed ##### -->
  <para>
    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.
  </para>

@calclient: the object which received the signal.
@arg1: 
<!-- # Unused Parameters # -->
@client: Calendar client which received the notification.
@uid: Unique identifier of the calendar component that was removed
  from the personal calendar server's storage.

<!--
Local variables:
mode: sgml
sgml-parent-document: ("../../../evolution-devel-guide.sgml" "book" "refsect2" "")
End:
-->

<!-- ##### SIGNAL CalClient::forget-password ##### -->
<para>

</para>

@calclient: the object which received the signal.
@arg1: