## EBookView

EBookView — Represents a search against an EBook.

## Synopsis

    struct              EBookView;
    void                e_book_view_start                   (EBookView *book_view);
    void                e_book_view_stop                    (EBookView *book_view);
    struct _EBook *		   e_book_view_get_book                (EBookView *book_view);

## Object Hierarchy

      GObject
       +----EBookView

## Signals

      "contacts-added"                                 : Run Last
      "contacts-changed"                               : Run Last
      "contacts-removed"                               : Run Last
      "sequence-complete"                              : Run Last
      "status-message"                                 : Run Last
      "view-complete"                                  : Run Last

## Description

Event notifications and callbacks from EBookView go to the EBookViewListener. Contrast EBookView with EBook, which represents the addressbook itself.

## Details

### struct EBookView

    struct EBookView;

### Warning

`EBookView` is deprecated and should not be used in newly-written code.

EBookView has no publicly available members.

### e_book_view_start ()

    void                e_book_view_start                   (EBookView *book_view);

### Warning

`e_book_view_start` is deprecated and should not be used in newly-written code.

Tells `book_view` to start processing events.

`book_view` : | an EBookView

### e_book_view_stop ()

    void                e_book_view_stop                    (EBookView *book_view);

### Warning

`e_book_view_stop` is deprecated and should not be used in newly-written code.

Tells `book_view` to stop processing events.

`book_view` : | an EBookView

### e_book_view_get_book ()

    struct _EBook *		   e_book_view_get_book                (EBookView *book_view);

### Warning

`e_book_view_get_book` is deprecated and should not be used in newly-written code.

Returns the EBook that this book view is monitoring.

`book_view` : | an EBookView
Returns : | an EBook. [transfer none]

Since 2.22

## Signal Details

### The `"contacts-added"` signal

    void                user_function                      (EBookView *ebookview,
                                                            gpointer   arg1,
                                                            gpointer   user_data)      : Run Last

Fired when more contacts are found. Each contact in the list will be unref'd when done, and the list freed, so simply reference any contacts you want to keep.

`ebookview` : | the object which received the signal.
`arg1` : | a GList of EContact objects that were added to the view
`user_data` : | user data set when the signal handler was connected.

### The `"contacts-changed"` signal

    void                user_function                      (EBookView *ebookview,
                                                            gpointer   arg1,
                                                            gpointer   user_data)      : Run Last

Fired when contacts are changed. Each contact in the list will be unref'd when done, and the list freed, so simply reference any contacts you want to keep.

`ebookview` : | the object which received the signal.
`arg1` : | a GList of EContact objects that were modified
`user_data` : | user data set when the signal handler was connected.

### The `"contacts-removed"` signal

    void                user_function                      (EBookView *ebookview,
                                                            gpointer   arg1,
                                                            gpointer   user_data)      : Run Last

Fired when contacts are removed from the view. The IDs and the list will be freed, so copy any IDs you want to keep.

`ebookview` : | the object which received the signal.
`arg1` : | a GList of contact IDs (char*) that were removed from the view
`user_data` : | user data set when the signal handler was connected.

### The `"sequence-complete"` signal

    void                user_function                      (EBookView *ebookview,
                                                            guint      arg1,
                                                            gpointer   user_data)      : Run Last

Fired when there are currently no more contacts to send. This is fired once after the initial set of contacts-added signals, and after every future change.

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

### The `"status-message"` signal

    void                user_function                      (EBookView *ebookview,
                                                            gchar     *arg1,
                                                            gpointer   user_data)      : Run Last

Fired with a status message reporting the progress of the view.

`ebookview` : | the object which received the signal.
`arg1` : | a const char* message
`user_data` : | user data set when the signal handler was connected.

### The `"view-complete"` signal

    void                user_function                      (EBookView *ebookview,
                                                            guint      arg1,
                                                            gchar     *arg2,
                                                            gpointer   user_data)      : Run Last

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

## See Also

EBookViewListener, EBook.