osso-abook-dialogs

osso-abook-dialogs — Collection of dialog helper routines.

Synopsis

gboolean            osso_abook_delete_contact_dialog_run
                                                        (GtkWindow *parent,
                                                         OssoABookRoster *roster,
                                                         OssoABookContact *contact);
void                osso_abook_delete_contacts_dialog_run
                                                        (GtkWindow *parent,
                                                         OssoABookRoster *roster,
                                                         OssoABookContactModel *model);
EVCardAttribute*    osso_abook_choose_im_dialog_run     (GtkWindow *parent,
                                                         OssoABookContact *contact,
                                                         OssoABookCapsFlags type);
GList*              osso_abook_choose_email_dialog_run  (GtkWindow *parent,
                                                         EContact *contact);
char*               osso_abook_choose_url_dialog_run    (GtkWindow *parent,
                                                         EContact *contact);
void                osso_abook_add_contact_dialog_run   (GtkWindow *parent);
void                osso_abook_add_im_account_dialog_run
                                                        (GtkWindow *parent);

Description

Helper routines to display dialogs and hook them up to all the necessary signals. Includes dialogs to delete and block contacts, create, delete and rename groups, choose email address from a contact and add a contact.

Details

osso_abook_delete_contact_dialog_run ()

gboolean            osso_abook_delete_contact_dialog_run
                                                        (GtkWindow *parent,
                                                         OssoABookRoster *roster,
                                                         OssoABookContact *contact);

Runs a dialog confirming whether contact should be deleted, and deletes it if the user's response is positive.

parent : The parent GtkWindow
roster : The OssoABookRoster from which contact originates
contact : An OssoABookContact
Returns : TRUE if the user response is positive, FALSE otherwise.

osso_abook_delete_contacts_dialog_run ()

void                osso_abook_delete_contacts_dialog_run
                                                        (GtkWindow *parent,
                                                         OssoABookRoster *roster,
                                                         OssoABookContactModel *model);

Runs a contact chooser dialog for the user to select contacts to delete, and confirms that the user is sure they want to delete them before doing so.

parent : The parent GtkWindow
roster : The OssoABookRoster from which contact originates
model : An OssoABookContactModel from which the user may select

osso_abook_choose_im_dialog_run ()

EVCardAttribute*    osso_abook_choose_im_dialog_run     (GtkWindow *parent,
                                                         OssoABookContact *contact,
                                                         OssoABookCapsFlags type);

parent :
contact :
type :
Returns :

osso_abook_choose_email_dialog_run ()

GList*              osso_abook_choose_email_dialog_run  (GtkWindow *parent,
                                                         EContact *contact);

Runs a dialog asking the user to choose email addresses from the email addresses defined in the contact.

parent : The parent GtkWindow
contact : The EContact
Returns : A GList of email addresses. The GList and its elements should be freed.

osso_abook_choose_url_dialog_run ()

char*               osso_abook_choose_url_dialog_run    (GtkWindow *parent,
                                                         EContact *contact);

Runs a dialog asking the user to choose a URL from the URLs defined in the contact.

parent : The parent GtkWindow
contact : The EContact
Returns : the URL. This string should be freed.

osso_abook_add_contact_dialog_run ()

void                osso_abook_add_contact_dialog_run   (GtkWindow *parent);

Runs a dialog asking whether to create a new contact.

parent : The parent GtkWindow

osso_abook_add_im_account_dialog_run ()

void                osso_abook_add_im_account_dialog_run
                                                        (GtkWindow *parent);

parent :