![]() |
![]() |
![]() |
Evolution Utilities Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
#include <e-util/e-util.h> struct EMailIdentityComboBox; GtkWidget * e_mail_identity_combo_box_new (ESourceRegistry *registry
); void e_mail_identity_combo_box_refresh (EMailIdentityComboBox *combo_box
); ESourceRegistry * e_mail_identity_combo_box_get_registry (EMailIdentityComboBox *combo_box
); gboolean e_mail_identity_combo_box_get_allow_none (EMailIdentityComboBox *combo_box
); void e_mail_identity_combo_box_set_allow_none (EMailIdentityComboBox *combo_box
,gboolean allow_none
);
EMailIdentity is a combo box of available mail identities, as described by ESource instances with an ESourceMailIdentity extension. For convenience, the combo box model's "id-column" is populated with ESource "uid" strings.
struct EMailIdentityComboBox { GtkComboBox parent; EMailIdentityComboBoxPrivate *priv; };
Contains only private data that should be read and manipulated using the functions below.
GtkWidget * e_mail_identity_combo_box_new (ESourceRegistry *registry
);
Creates a new EMailIdentityComboBox widget using ESource instances in
registry
.
|
an ESourceRegistry |
Returns : |
a new EMailIdentityComboBox |
void e_mail_identity_combo_box_refresh (EMailIdentityComboBox *combo_box
);
Rebuilds the combo box model with an updated list of ESource instances that describe a mail identity, without disrupting the previously active item (if possible).
This function is called automatically in response to ESourceRegistry
signals which are pertinent to the combo_box
.
|
an EMailIdentityComboBox |
ESourceRegistry * e_mail_identity_combo_box_get_registry
(EMailIdentityComboBox *combo_box
);
Returns the ESourceRegistry passed to e_mail_identity_combo_box_new()
.
|
an EMailIdentityComboBox |
Returns : |
an ESourceRegistry |
gboolean e_mail_identity_combo_box_get_allow_none
(EMailIdentityComboBox *combo_box
);
Returns whether to append the mail identity list with a "None" item for use cases where the user may wish to opt out of choosing a mail identity.
|
an EMailIdentityComboBox |
Returns : |
whether to include a "None" option |
void e_mail_identity_combo_box_set_allow_none (EMailIdentityComboBox *combo_box
,gboolean allow_none
);
Sets whether to append the mail identity list with a "None" item for use cases where the user may wish to opt out of choosing a mail identity.
Changing this property will automatically rebuild the combo box model.
|
an EMailIdentityComboBox |
|
whether to include a "None" option |