| libempathy-gtk Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | ||||
EmpathyContactWidgetEmpathyContactWidget — A widget used to display and edit details about a contact |
#include <libempathy-empathy-contact-widget.h> enum EmpathyContactWidgetFlags; GtkWidget * empathy_contact_widget_new (EmpathyContact *contact, EmpathyContactWidgetFlags flags); EmpathyContact * empathy_contact_widget_get_contact (GtkWidget *widget); void empathy_contact_widget_set_contact (GtkWidget *widget, EmpathyContact *contact); void empathy_contact_widget_set_account_filter (GtkWidget *widget, EmpathyAccountChooserFilterFunc filter, gpointer user_data);
EmpathyContactWidget is a widget which displays appropriate widgets with details about a contact, also allowing changing these details, if desired.
typedef enum
{
EMPATHY_CONTACT_WIDGET_EDIT_NONE = 0,
EMPATHY_CONTACT_WIDGET_EDIT_ALIAS = 1 << 0,
EMPATHY_CONTACT_WIDGET_EDIT_AVATAR = 1 << 1,
EMPATHY_CONTACT_WIDGET_EDIT_ACCOUNT = 1 << 2,
EMPATHY_CONTACT_WIDGET_EDIT_ID = 1 << 3,
EMPATHY_CONTACT_WIDGET_EDIT_GROUPS = 1 << 4,
EMPATHY_CONTACT_WIDGET_FOR_TOOLTIP = 1 << 5,
} EmpathyContactWidgetFlags;
Flags used when creating an EmpathyContactWidget to specify which features should be available.
| Don't show any widgets to edit any details of the contact. This should be the option for widgets that merely display information about a contact. | |
| Show a GtkEntry allowing changes to the contact's alias. | |
| Show an EmpathyAvatarChooser allowing changes to the contact's avatar. | |
| Show an EmpathyAccountChooser allowing changes to the contact's account. | |
| Show a GtkEntry allowing changes to the contact's identifier. | |
| Show a widget to change the groups the contact is in. | |
| Make widgets more designed for a tooltip. For example, make widgets not selectable. |
GtkWidget * empathy_contact_widget_new (EmpathyContact *contact, EmpathyContactWidgetFlags flags);
Creates a new EmpathyContactWidget.
|
an EmpathyContact |
|
EmpathyContactWidgetFlags for the new contact widget |
Returns : |
a new EmpathyContactWidget |
EmpathyContact * empathy_contact_widget_get_contact (GtkWidget *widget);
Get the EmpathyContact related with the EmpathyContactWidget widget.
|
an EmpathyContactWidget |
Returns : |
the EmpathyContact associated with widget
|
void empathy_contact_widget_set_contact (GtkWidget *widget, EmpathyContact *contact);
Change the EmpathyContact related with the EmpathyContactWidget widget.
|
an EmpathyContactWidget |
|
a different EmpathyContact |
void empathy_contact_widget_set_account_filter
(GtkWidget *widget,
EmpathyAccountChooserFilterFunc filter,
gpointer user_data);
Set a filter on the EmpathyAccountChooser included in the EmpathyContactWidget.
|
an EmpathyContactWidget |
|
a EmpathyAccountChooserFilterFunc |
|
user data to pass to filter, or NULL
|