osso-abook-dialogs

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

Synopsis




gboolean    osso_abook_delete_contact_dialog_run
                                            (GtkWindow *parent,
                                             EBookView *book_view,
                                             EContact *contact);
void        osso_abook_delete_contacts_dialog_run
                                            (GtkWindow *parent,
                                             EBookView *book_view,
                                             GList *contacts);
void        osso_abook_block_contact_dialog_run
                                            (GtkWindow *parent,
                                             EBookView *book_view,
                                             EContact *contact);
OssoABookGroup* osso_abook_new_group_dialog_run
                                            (GtkWindow *parent);
void        osso_abook_rename_group_dialog_run
                                            (GtkWindow *parent,
                                             OssoABookContactModel *model,
                                             OssoABookManualGroup *group);
void        osso_abook_delete_group_dialog_run
                                            (GtkWindow *parent,
                                             OssoABookContactModel *model,
                                             OssoABookManualGroup *group);
void        osso_abook_add_contact_dialog_run
                                            (GtkWindow *parent,
                                             EBookView *book_view);
GList*      osso_abook_choose_email_dialog_run
                                            (GtkWindow *parent,
                                             EContact *contact);
OssoABookAccount* osso_abook_choose_im_dialog_run
                                            (GtkWindow *parent,
                                             EContact *contact,
                                             OssoABookAccountTypeFlags type);

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,
                                             EBookView *book_view,
                                             EContact *contact);

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

`parent` :	The parent GtkWindow
`book_view` :	The EBookView from which `contact` originates
`contact` :	An EContact
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,
                                             EBookView *book_view,
                                             GList *contacts);

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

`parent` :	The parent GtkWindow
`book_view` :	The EBookView from which `contact` originates
`contacts` :	A list of EContacts

osso_abook_block_contact_dialog_run ()

void        osso_abook_block_contact_dialog_run
                                            (GtkWindow *parent,
                                             EBookView *book_view,
                                             EContact *contact);

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

`parent` :	The parent GtkWindow
`book_view` :	The EBookView from which `contact` originates
`contact` :	An EContact

osso_abook_new_group_dialog_run ()

OssoABookGroup* osso_abook_new_group_dialog_run
                                            (GtkWindow *parent);

Runs a dialog asking a name for a new group, and creates a new group accordingly.

`parent` :	The parent GtkWindow
Returns :	The created OssoABookManualGroup.

osso_abook_rename_group_dialog_run ()

void        osso_abook_rename_group_dialog_run
                                            (GtkWindow *parent,
                                             OssoABookContactModel *model,
                                             OssoABookManualGroup *group);

Runs a dialog asking a new name for group, and renames group accordingly.

`parent` :	The parent GtkWindow
`model` :	The OssoABookContactModel to update
`group` :	The OssoABookManualGroup to be renamed

osso_abook_delete_group_dialog_run ()

void        osso_abook_delete_group_dialog_run
                                            (GtkWindow *parent,
                                             OssoABookContactModel *model,
                                             OssoABookManualGroup *group);

Runs a dialog confirming the deletion of group, and deletes it if the user's response is positive.

`parent` :	The parent GtkWindow
`model` :	The OssoABookContactModel to update
`group` :	The OssoABookManualGroup to be deleted

osso_abook_add_contact_dialog_run ()

void        osso_abook_add_contact_dialog_run
                                            (GtkWindow *parent,
                                             EBookView *book_view);

Runs a dialog asking whether to create a new contact.

`parent` :	The parent GtkWindow
`book_view` :	An EBookView

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_im_dialog_run ()

OssoABookAccount* osso_abook_choose_im_dialog_run
                                            (GtkWindow *parent,
                                             EContact *contact,
                                             OssoABookAccountTypeFlags type);

Runs a dialog asking the user to choose an IM address from the IM addresses defined in the contact. type should be either OSSO_ABOOK_ACCOUNT_TYPE_CHAT or OSSO_ABOOK_ACCOUNT_TYPE_CALL.

This function should not be used. Use osso_abook_choose_im_dialog instead.

`parent` :	The parent GtkWindow
`contact` :	The EContact
`type` :	A OssoABookAccountTypeFlags specifying what type of account to select
Returns :	A OssoABookAccount or NULL if no account was selected. This object should be unref'd when it is unneeded.