## EBookView

EBookView — Represents a search against an EBook.

## Synopsis

                EBookView;
    EBookView*  e_book_view_new                 (GNOME_Evolution_Addressbook_BookView corba_book_view,
                                                 EBookViewListener *listener);
    void        e_book_view_set_book            (EBookView *book_view,
                                                 struct _EBook *book);
    void        e_book_view_start               (EBookView *book_view);
    void        e_book_view_stop                (EBookView *book_view);

## Object Hierarchy

      GObject
       +----EBookView

## Signal Prototypes

    "contacts-added"
                void        user_function      (EBookView *ebookview,
                                                gpointer arg1,
                                                gpointer user_data);
    "contacts-changed"
                void        user_function      (EBookView *ebookview,
                                                gpointer arg1,
                                                gpointer user_data);
    "contacts-removed"
                void        user_function      (EBookView *ebookview,
                                                gpointer arg1,
                                                gpointer user_data);
    "sequence-complete"
                void        user_function      (EBookView *ebookview,
                                                gint arg1,
                                                gpointer user_data);
    "status-message"
                void        user_function      (EBookView *ebookview,
                                                gchar *arg1,
                                                gpointer user_data);

## Description

Event notifications and callbacks from EBookView go to the e-book-view-listener. Contrast EBookView with e-book, which represents the addressbook itself.

## Details

### EBookView

    typedef struct _EBookView EBookView;

### e_book_view_new ()

    EBookView*  e_book_view_new                 (GNOME_Evolution_Addressbook_BookView corba_book_view,
                                                 EBookViewListener *listener);

`corba_book_view` : |
`listener` : |
Returns : |

### e_book_view_set_book ()

    void        e_book_view_set_book            (EBookView *book_view,
                                                 struct _EBook *book);

`book_view` : |
`book` : |

### e_book_view_start ()

    void        e_book_view_start               (EBookView *book_view);

`book_view` : |

### e_book_view_stop ()

    void        e_book_view_stop                (EBookView *book_view);

`book_view` : |

## Signals

### The "contacts-added" signal

    void        user_function                  (EBookView *ebookview,
                                                gpointer arg1,
                                                gpointer user_data);

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` : |
`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);

`ebookview` : | the object which received the signal.
`arg1` : |
`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);

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

### The "sequence-complete" signal

    void        user_function                  (EBookView *ebookview,
                                                gint arg1,
                                                gpointer user_data);

`ebookview` : | the object which received the signal.
`arg1` : |
`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);

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

## See Also

e-book-view-listener, e-book