e_source_combo_box_new ()

GtkWidget *
e_source_combo_box_new (ESourceRegistry *registry,
                        const gchar *extension_name);

Creates a new ESourceComboBox widget that lets the user pick an ESource from the provided ESourceRegistry. The displayed sources are restricted to those which have an extension_name extension.

Since: 2.22

e_source_combo_box_get_registry ()

ESourceRegistry *
e_source_combo_box_get_registry (ESourceComboBox *combo_box);

Returns the ESourceRegistry used to populate combo_box .

Since: 3.6

e_source_combo_box_set_registry ()

void
e_source_combo_box_set_registry (ESourceComboBox *combo_box,
                                 ESourceRegistry *registry);

Sets the ESourceRegistry used to populate combo_box .

This function is intended for cases where combo_box is instantiated by a GtkBuilder and has to be given an ESourceRegistry after it is fully constructed.

Since: 3.6

e_source_combo_box_get_extension_name ()

const gchar *
e_source_combo_box_get_extension_name (ESourceComboBox *combo_box);

Returns the extension name used to filter which data sources are shown in combo_box .

Since: 3.6

e_source_combo_box_set_extension_name ()

void
e_source_combo_box_set_extension_name (ESourceComboBox *combo_box,
                                       const gchar *extension_name);

Sets the extension name used to filter which data sources are shown in combo_box .

Since: 3.6

e_source_combo_box_get_show_colors ()

gboolean
e_source_combo_box_get_show_colors (ESourceComboBox *combo_box);

Returns whether colors are shown next to data sources.

Since: 3.6

e_source_combo_box_set_show_colors ()

void
e_source_combo_box_set_show_colors (ESourceComboBox *combo_box,
                                    gboolean show_colors);

Sets whether to show colors next to data sources.

Since: 3.6

e_source_combo_box_ref_active ()

ESource *
e_source_combo_box_ref_active (ESourceComboBox *combo_box);

Returns the ESource corresponding to the currently active item, or NULL if there is no active item.

The returned ESource is referenced for thread-safety and must be unreferenced with g_object_unref() when finished with it.

Since: 3.6

e_source_combo_box_set_active ()

void
e_source_combo_box_set_active (ESourceComboBox *combo_box,
                               ESource *source);

Sets the active item to the one corresponding to source .

Since: 2.22

e_source_combo_box_hide_sources ()

void
e_source_combo_box_hide_sources (ESourceComboBox *combo_box,
                                 ...);

The UID-s can be also backend names. Apart of that, these are checked for both the ESource::uid and the ESource::parent.

The next call replaces the list of source UID-s to be hidden.

Since: 3.40

e_source_combo_box_get_max_natural_width ()

gint
e_source_combo_box_get_max_natural_width
                               (ESourceComboBox *combo_box);

Returns max natural width for the combo box. The default is -1, which means to use what the gtk+ calculates. Positive values clamp the natural width and enable ellipsizing for the ESource name.

Since: 3.46

e_source_combo_box_set_max_natural_width ()

void
e_source_combo_box_set_max_natural_width
                               (ESourceComboBox *combo_box,
                                gint value);

Sets max natural width for the combo box. Use -1 to use what the gtk+ calculates. Positive values clamp the natural width and enable ellipsizing for the ESource name.

Since: 3.46

e_source_combo_box_get_show_full_name ()

gboolean
e_source_combo_box_get_show_full_name (ESourceComboBox *combo_box);

Returns whether should show full name of the sources.

Since: 3.50

e_source_combo_box_set_show_full_name ()

void
e_source_combo_box_set_show_full_name (ESourceComboBox *combo_box,
                                       gboolean show_full_name);

Sets whether should show full name of the sources.

Since: 3.50

struct ESourceComboBox

struct ESourceComboBox;

Since: 2.22

The “extension-name” property

  “extension-name”           char *

ESource extension name to filter.

Owner: ESourceComboBox

Flags: Read / Write / Construct

Default value: NULL

The “max-natural-width” property

  “max-natural-width”        int

Owner: ESourceComboBox

Flags: Read / Write / Construct

Default value: -1

The “registry” property

  “registry”                 ESourceRegistry *

Data source registry.

Owner: ESourceComboBox

Flags: Read / Write / Construct

The “show-colors” property

  “show-colors”              gboolean

Whether to show colors next to names.

Owner: ESourceComboBox

Flags: Read / Write / Construct

Default value: TRUE