![]() |
![]() |
![]() |
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, EMPATHY_CONTACT_WIDGET_SHOW_LOCATION = 1 << 6, } 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
|