Refactored the code that offers UI to add contacts to address book
[modest] / src / modest-address-book.h
index 7fd41cb..8fea6fa 100644 (file)
@@ -51,7 +51,8 @@ modest_address_book_init (void);
  * 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:
@@ -67,15 +68,17 @@ modest_address_book_select_addresses (ModestRecptEditor *editor,
 /**
  * modest_address_book_check_names:
  * @editor: a #ModestRecptEditor
- * @update_addressbook: if TRUE, add valid addresses to the addressbook, recent list
- * 
+ * @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, gboolean update_addressbook);
+modest_address_book_check_names (ModestRecptEditor *editor,
+                                GSList **address_list);
 
 /**
  * modest_address_book_has_address:
@@ -108,4 +111,17 @@ modest_address_book_get_my_name ();
 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__ */