|  |  |  | 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, orNULL |