![]() |
![]() |
![]() |
libempathy-gtk Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties |
#include <libempathy-gtk/empathy-account-chooser.h> gboolean (*EmpathyAccountChooserFilterFunc) (EmpathyAccount *account, gpointer user_data); EmpathyAccountChooser; GtkWidget * empathy_account_chooser_new (void); EmpathyAccount * empathy_account_chooser_dup_account (EmpathyAccountChooser *chooser); TpConnection * empathy_account_chooser_get_connection (EmpathyAccountChooser *chooser); gboolean empathy_account_chooser_set_account (EmpathyAccountChooser *chooser, EmpathyAccount *account); gboolean empathy_account_chooser_get_has_all_option (EmpathyAccountChooser *chooser); void empathy_account_chooser_set_has_all_option (EmpathyAccountChooser *chooser, gboolean has_all_option); void empathy_account_chooser_set_filter (EmpathyAccountChooser *chooser, EmpathyAccountChooserFilterFunc filter, gpointer user_data); gboolean empathy_account_chooser_filter_is_connected (EmpathyAccount *account, gpointer user_data);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkComboBox +----EmpathyAccountChooser
EmpathyAccountChooser implements AtkImplementorIface, GtkBuildable, GtkCellLayout and GtkCellEditable.
EmpathyAccountChooser is a widget which extends GtkComboBox to provide a chooser of available accounts.
gboolean (*EmpathyAccountChooserFilterFunc) (EmpathyAccount *account, gpointer user_data);
A function which decides whether the account indicated by account
is visible.
|
an EmpathyAccount |
|
user data, or NULL
|
Returns : |
whether the account indicated by account is visible.
|
typedef struct _EmpathyAccountChooser EmpathyAccountChooser;
Widget which extends GtkComboBox to provide a chooser of available accounts.
GtkWidget * empathy_account_chooser_new (void);
Creates a new EmpathyAccountChooser.
Returns : |
A new EmpathyAccountChooser |
EmpathyAccount * empathy_account_chooser_dup_account (EmpathyAccountChooser *chooser);
Returns the account which is currently selected in the chooser or NULL
if there is no account selected. The EmpathyAccount returned should be
unrefed with g_object_unref()
when finished with.
|
an EmpathyAccountChooser |
Returns : |
a new ref to the EmpathyAccount currently selected, or NULL .
|
TpConnection * empathy_account_chooser_get_connection (EmpathyAccountChooser *chooser);
Returns a borrowed reference to the TpConnection associated with the
account currently selected. The caller must reference the returned object with
g_object_ref()
if it will be kept
|
an EmpathyAccountChooser |
Returns : |
a borrowed reference to the TpConnection associated with the account curently selected. |
gboolean empathy_account_chooser_set_account (EmpathyAccountChooser *chooser, EmpathyAccount *account);
Sets the currently selected account to account
, if it exists in the list.
|
an EmpathyAccountChooser |
|
an EmpathyAccount |
Returns : |
whether the chooser was set to account .
|
gboolean empathy_account_chooser_get_has_all_option (EmpathyAccountChooser *chooser);
Returns whether chooser
has the "has-all-option" property
set to true.
|
an EmpathyAccountChooser |
Returns : |
whether chooser has the "has-all-option" property
enabled.
|
void empathy_account_chooser_set_has_all_option (EmpathyAccountChooser *chooser, gboolean has_all_option);
Sets the "has-all-option" property.
|
an EmpathyAccountChooser |
|
a new value for the "has-all-option" property |
void empathy_account_chooser_set_filter (EmpathyAccountChooser *chooser, EmpathyAccountChooserFilterFunc filter, gpointer user_data);
Sets a filter on the chooser
so only accounts that are TRUE
in the eyes
of the filter are visible in the chooser
.
|
an EmpathyAccountChooser |
|
a filter |
|
data to pass to filter , or NULL
|
gboolean empathy_account_chooser_filter_is_connected (EmpathyAccount *account, gpointer user_data);
A useful EmpathyAccountChooserFilterFunc that one could pass into
empathy_account_chooser_set_filter()
and only show connected accounts.
|
an EmpathyAccount |
|
user data or NULL
|
Returns : |
Whether account is connected
|
"has-all-option"
property"has-all-option" gboolean : Read / Write
Have an additional option in the list to mean all accounts.
Default value: FALSE