![]() |
![]() |
![]() |
Osso Addressbook Reference Manual | ![]() |
---|---|---|---|---|
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);
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.
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. |
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 |
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. |
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 |
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. |
void osso_abook_add_contact_dialog_run (GtkWindow *parent);
Runs a dialog asking whether to create a new contact.
parent : |
The parent GtkWindow |
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 |
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 |