|
|
|
Osso Addressbook Reference Manual | |
|---|---|---|---|---|
gboolean osso_abook_delete_contact_dialog_run (GtkWindow *parent, OssoABookRoster *roster, OssoABookContact *contact); void osso_abook_confirm_delete_contacts_dialog_run (GtkWindow *parent, OssoABookRoster *roster, GList *contacts); 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_confirm_delete_contacts_dialog_run
(GtkWindow *parent,
OssoABookRoster *roster,
GList *contacts);
Runs a confirmation dialog asking the user if (s)he really wants to delete
the contacts in contacts and, if the user confirms, delete them.
parent : |
The parent GtkWindow |
roster : |
The OssoABookRoster from which contact originates, or NULL to
use the system one
|
contacts : |
a GList of OssoABookContacts to delete |
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 |