## ECalListener

ECalListener — Listens for responses and event notifications sent by an e-cal.

## Synopsis

                        ECalListener;
    void                (*ECalListenerCalSetModeFn)         (ECalListener *listener,
                                                             GNOME_Evolution_Calendar_CalListener_SetModeStatus status,
                                                             GNOME_Evolution_Calendar_CalMode mode,
                                                             gpointer data);
    ECalListener *      e_cal_listener_construct            (ECalListener *listener,
                                                             ECalListenerCalSetModeFn cal_set_mode_fn,
                                                             gpointer fn_data);
    ECalListener *      e_cal_listener_new                  (ECalListenerCalSetModeFn cal_set_mode_fn,
                                                             gpointer fn_data);
    void                e_cal_listener_stop_notification    (ECalListener *listener);

## Object Hierarchy

      GObject
       +----BonoboObject
             +----ECalListener

## Signals

      "add-timezone"                                   : Run Last
      "alarm-address"                                  : Run Last
      "attachment-list"                                : Run Last
      "auth-required"                                  : Run Last
      "backend-error"                                  : Run Last
      "cal-address"                                    : Run Last
      "create-object"                                  : Run Last
      "default-object"                                 : Run Last
      "discard-alarm"                                  : Run Last
      "get-changes"                                    : Run Last
      "get-free-busy"                                  : Run Last
      "get-timezone"                                   : Run Last
      "ldap-attribute"                                 : Run Last
      "modify-object"                                  : Run Last
      "object"                                         : Run Last
      "object-list"                                    : Run Last
      "open"                                           : Run Last
      "query"                                          : Run Last
      "read-only"                                      : Run Last
      "receive-objects"                                : Run Last
      "remove"                                         : Run Last
      "remove-object"                                  : Run Last
      "send-objects"                                   : Run Last
      "set-default-timezone"                           : Run Last
      "static-capabilities"                            : Run Last

## Description

Contrast with the e-cal-view-listener, which listens to e-cal-view.

## Details

### ECalListener

    typedef struct _ECalListener ECalListener;

### ECalListenerCalSetModeFn ()

    void                (*ECalListenerCalSetModeFn)         (ECalListener *listener,
                                                             GNOME_Evolution_Calendar_CalListener_SetModeStatus status,
                                                             GNOME_Evolution_Calendar_CalMode mode,
                                                             gpointer data);

`listener` : |
`status` : |
`mode` : |
`data` : |

### e_cal_listener_construct ()

    ECalListener *      e_cal_listener_construct            (ECalListener *listener,
                                                             ECalListenerCalSetModeFn cal_set_mode_fn,
                                                             gpointer fn_data);

Constructs all internal information for a calendar listener. This function usually does not need to be called, unless creating a ECalListener-derived class.

`listener` : | A calendar listener.
`cal_set_mode_fn` : | Function callback for notification that a calendar changed modes.
`fn_data` : | Closure data pointer that will be passed to the notification functions.
Returns : | the calendar listener ready to be used.

### e_cal_listener_new ()

    ECalListener *      e_cal_listener_new                  (ECalListenerCalSetModeFn cal_set_mode_fn,
                                                             gpointer fn_data);

Creates a new ECalListener object.

`cal_set_mode_fn` : | Function callback for notification that a calendar changed modes.
`fn_data` : | Closure data pointer that will be passed to the notification functions.
Returns : | A newly-created ECalListener object.

### e_cal_listener_stop_notification ()

    void                e_cal_listener_stop_notification    (ECalListener *listener);

Informs a calendar listener that no further notification is desired. The callbacks specified when the listener was created will no longer be invoked after this function is called.

`listener` : | A calendar listener.

## Signal Details

### The `"add-timezone"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gint          arg1,
                                                            gchar        *arg2,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`arg2` : |
`user_data` : | user data set when the signal handler was connected.

### The `"alarm-address"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gint          arg1,
                                                            gchar        *arg2,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`arg2` : |
`user_data` : | user data set when the signal handler was connected.

### The `"attachment-list"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gint          arg1,
                                                            gpointer      arg2,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`arg2` : |
`user_data` : | user data set when the signal handler was connected.

### The `"auth-required"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.

### The `"backend-error"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gchar        *arg1,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`user_data` : | user data set when the signal handler was connected.

### The `"cal-address"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gint          arg1,
                                                            gchar        *arg2,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`arg2` : |
`user_data` : | user data set when the signal handler was connected.

### The `"create-object"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gint          arg1,
                                                            gchar        *arg2,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`arg2` : |
`user_data` : | user data set when the signal handler was connected.

### The `"default-object"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gint          arg1,
                                                            gchar        *arg2,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`arg2` : |
`user_data` : | user data set when the signal handler was connected.

### The `"discard-alarm"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gint          arg1,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`user_data` : | user data set when the signal handler was connected.

### The `"get-changes"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gint          arg1,
                                                            gpointer      arg2,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`Param3` : |
`user_data` : | user data set when the signal handler was connected.

### The `"get-free-busy"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gint          arg1,
                                                            gpointer      arg2,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`Param3` : |
`user_data` : | user data set when the signal handler was connected.

### The `"get-timezone"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gint          arg1,
                                                            gchar        *arg2,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`arg2` : |
`user_data` : | user data set when the signal handler was connected.

### The `"ldap-attribute"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gint          arg1,
                                                            gchar        *arg2,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`arg2` : |
`user_data` : | user data set when the signal handler was connected.

### The `"modify-object"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gint          arg1,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`user_data` : | user data set when the signal handler was connected.

### The `"object"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gint          arg1,
                                                            gchar        *arg2,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`arg2` : |
`user_data` : | user data set when the signal handler was connected.

### The `"object-list"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gint          arg1,
                                                            gpointer      arg2,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`arg2` : |
`user_data` : | user data set when the signal handler was connected.

### The `"open"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gint          arg1,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`user_data` : | user data set when the signal handler was connected.

### The `"query"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gint          arg1,
                                                            gpointer      arg2,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`arg2` : |
`user_data` : | user data set when the signal handler was connected.

### The `"read-only"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gint          arg1,
                                                            gboolean      arg2,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`arg2` : |
`user_data` : | user data set when the signal handler was connected.

### The `"receive-objects"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gint          arg1,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`user_data` : | user data set when the signal handler was connected.

### The `"remove"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gint          arg1,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`user_data` : | user data set when the signal handler was connected.

### The `"remove-object"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gint          arg1,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`user_data` : | user data set when the signal handler was connected.

### The `"send-objects"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gint          arg1,
                                                            gpointer      arg2,
                                                            gchar        *arg3,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`Param3` : |
`Param4` : |
`user_data` : | user data set when the signal handler was connected.

### The `"set-default-timezone"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gint          arg1,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`user_data` : | user data set when the signal handler was connected.

### The `"static-capabilities"` signal

    void                user_function                      (ECalListener *ecallistener,
                                                            gint          arg1,
                                                            gchar        *arg2,
                                                            gpointer      user_data)         : Run Last

`ecallistener` : | the object which received the signal.
`arg1` : |
`arg2` : |
`user_data` : | user data set when the signal handler was connected.

## See Also

ECal, ECalViewListener