Dialogs

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);
GList*              osso_abook_choose_email_dialog_run  (GtkWindow *parent,
                                                         EContact *contact);
EVCardAttribute*    osso_abook_choose_im_dialog_run     (GtkWindow *parent,
                                                         OssoABookContact *contact,
                                                         OssoABookCapsFlags type);
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);
gboolean            osso_abook_launch_applet            (GtkWindow *parent,
                                                         const char *applet);

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_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 associated with the specified 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 ()

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

Runs a dialog asking the user to choose an IM or VoIP account from the accounts associated with the specified contact that satisfies the specified capabilities

parent : The parent GtkWindow
contact : The OssoABookContact
caps : The capabilities that the account must satisfy
Returns : An EVCardAttribute indicating the account that was selected. The EVCardAttribute is owned by the contact and should not 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 associated with the specified 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);

Runs a dialog that shows a list of of configured IM and VoIP accounts and allows the user to create new accounts or edit existing accounts

parent : The parent GtkWindow

osso_abook_launch_applet ()

gboolean            osso_abook_launch_applet            (GtkWindow *parent,
                                                         const char *applet);

Attempts the launch the control panel applet specified by the name applet

parent : The parent GtkWindow
applet : The name of the control panel applet to run
Returns : TRUE if the applet was launched successfully, FALSE otherwise