## ECalClientView

ECalClientView

## Synopsis

    struct              ECalClientView;
    struct _ECalClient * e_cal_client_view_get_client       (ECalClientView *view);
    gboolean            e_cal_client_view_is_running        (ECalClientView *view);
    void                e_cal_client_view_set_fields_of_interest
                                                            (ECalClientView *view,
                                                             const GSList *fields_of_interest,
                                                             GError **error);
    void                e_cal_client_view_start             (ECalClientView *view,
                                                             GError **error);
    void                e_cal_client_view_stop              (ECalClientView *view,
                                                             GError **error);

## Object Hierarchy

      GObject
       +----ECalClientView

## Properties

      "client"                   ECalClient*           : Read / Write / Construct Only
      "view"                     gpointer              : Read / Write / Construct Only

## Signals

      "complete"                                       : Run First
      "objects-added"                                  : Run First
      "objects-modified"                               : Run First
      "objects-removed"                                : Run First
      "progress"                                       : Run First

## Description

## Details

### struct ECalClientView

    struct ECalClientView;

### e_cal_client_view_get_client ()

    struct _ECalClient * e_cal_client_view_get_client       (ECalClientView *view);

Get the ECalClient associated with this view.

`view` : | A ECalClientView object.
Returns : | the associated client.

### e_cal_client_view_is_running ()

    gboolean            e_cal_client_view_is_running        (ECalClientView *view);

Retunrs: Whether view is running. Not running views are ignoring all events sent from the server.

`view` : | an ECalClientView

### e_cal_client_view_set_fields_of_interest ()

    void                e_cal_client_view_set_fields_of_interest
                                                            (ECalClientView *view,
                                                             const GSList *fields_of_interest,
                                                             GError **error);

Client can instruct server to which fields it is interested in only, thus the server can return less data over the wire. The server can still return complete objects, this is just a hint to it that the listed fields will be used only. The UID/RID fields are returned always. Initial views has no fields of interest and using `NULL` for `fields_of_interest` will unset any previous changes.

Some backends can use summary information of its cache to create artifical objects, which will omit stored object parsing. If this cannot be done then it will simply return object as is stored in the cache.

`view` : | An ECalClientView object
`fields_of_interest` : | List of field names in which the client is interested
`error` : | A GError

### e_cal_client_view_start ()

    void                e_cal_client_view_start             (ECalClientView *view,
                                                             GError **error);

Starts a live query to the calendar/tasks backend.

`view` : | An ECalClientView object.
`error` : | A Gerror

### e_cal_client_view_stop ()

    void                e_cal_client_view_stop              (ECalClientView *view,
                                                             GError **error);

Stops a live query to the calendar/tasks backend.

`view` : | An ECalClientView object.
`error` : | A GError

## Property Details

### The `"client"` property

      "client"                   ECalClient*           : Read / Write / Construct Only

### The `"view"` property

      "view"                     gpointer              : Read / Write / Construct Only

## Signal Details

### The `"complete"` signal

    void                user_function                      (ECalClientView *ecalclientview,
                                                            GError         *arg1,
                                                            gpointer        user_data)           : Run First

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

### The `"objects-added"` signal

    void                user_function                      (ECalClientView *view:,
                                                            gpointer        objects,
                                                            gpointer        user_data)      : Run First

`view:` : | self
`objects` : | . [type GSList][transfer none][element-type long]
`user_data` : | user data set when the signal handler was connected.

### The `"objects-modified"` signal

    void                user_function                      (ECalClientView *view:,
                                                            gpointer        objects,
                                                            gpointer        user_data)      : Run First

`view:` : | self
`objects` : | . [type GSList][transfer none][element-type long]
`user_data` : | user data set when the signal handler was connected.

### The `"objects-removed"` signal

    void                user_function                      (ECalClientView *view:,
                                                            gpointer        objects,
                                                            gpointer        user_data)      : Run First

`view:` : | self
`objects` : | . [type GSList][transfer none][element-type ECalComponentId]
`user_data` : | user data set when the signal handler was connected.

### The `"progress"` signal

    void                user_function                      (ECalClientView *ecalclientview,
                                                            guint           arg1,
                                                            gchar          *arg2,
                                                            gpointer        user_data)           : Run First

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