X-Git-Url: http://git.maemo.org/git/?p=modest;a=blobdiff_plain;f=src%2Fmodest-address-book.h;h=8fea6fa1d35c7914d6b53633f54d3ee69b523657;hp=75a1a9a2c25472776ed28a16583d92eb8d31b259;hb=12a672c559d983c4e49a7e4054ee14c0177ecb1c;hpb=32ba35b63ed6986eab57acf8bfd76dba10ee129e diff --git a/src/modest-address-book.h b/src/modest-address-book.h index 75a1a9a..8fea6fa 100644 --- a/src/modest-address-book.h +++ b/src/modest-address-book.h @@ -32,7 +32,17 @@ #ifndef __MODEST_ADDRESS_BOOK_H__ #define __MODEST_ADDRESS_BOOK_H__ +#include #include +#include + +/** + * modest_address_book_init: + * + * initializes the addressbook + */ +void +modest_address_book_init (void); /** * modest_address_book_add_address: @@ -41,18 +51,77 @@ * launches the UI for adding @address to the addressbook */ void -modest_address_book_add_address (const gchar *address); +modest_address_book_add_address (const gchar *address, + GtkWindow *parent); /** * modest_address_book_select_addresses: * * Shows a dialog to select some addresses from the - * address book. + * address book. It adds them to the recipient editor + * + */ +void +modest_address_book_select_addresses (ModestRecptEditor *editor, + GtkWindow *parent_window); + +/** + * modest_address_book_check_names: + * @editor: a #ModestRecptEditor + * @address_list: if it is not NULL, this list is filled with the + * valid addresses ready to be added to the address book + * + * Performs verification of addresses in a recipient editor. + * + * Returns: %TRUE if all recipients are valid or there are + * no recipients, %FALSE otherwise. + */ +gboolean +modest_address_book_check_names (ModestRecptEditor *editor, + GSList **address_list); + +/** + * modest_address_book_has_address: + * @address: a string * - * Returns: a string with the addresses + * Checks if an address is already stored in addressbook. + * + * Returns: %TRUE is @address is in addressbook. %FALSE otherwise. */ -gchar * -modest_address_book_select_addresses (void); +gboolean +modest_address_book_has_address (const gchar *address); + +/** + * modest_address_book_get_my_name: + * @: + * + * Returns user name from user's own vcard + * + * Returns: the user full name + **/ +const gchar * +modest_address_book_get_my_name (); +/** + * modest_address_book_add_address_list: + * @address_list: a list of email addresses to add to the addressbook + * + * Inserts a list of addresses in the addressbook + **/ +void +modest_address_book_add_address_list (GSList *address_list); + +/** + * modest_address_book_add_address_list_with_selector: + * @address_list: a list of email addresses to add to the addressbook + * @parent: the parent window. The UI elements shown to the user + * (tipically a dialog) will have that window as parent + * + * Presents some UI to the users to allow them to select and then + * insert a list of selected addresses in the addressbook. + **/ +void +modest_address_book_add_address_list_with_selector (GSList *address_list, + GtkWindow *parent); #endif /* __MODEST_ADDRESS_BOOK_H__ */