struct ESourceSelector

struct ESourceSelector;

e_source_selector_new ()

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

Displays a list of sources from registry having an extension named extension_name. The sources are grouped by backend or groupware account, which are described by the parent source.

e_source_selector_get_registry ()

ESourceRegistry *   e_source_selector_get_registry      (ESourceSelector *selector);

Returns the ESourceRegistry that selector is getting sources from.

Since 3.6

e_source_selector_get_extension_name ()

const gchar *       e_source_selector_get_extension_name
                                                        (ESourceSelector *selector);

Returns the extension name used to filter which sources are displayed.

Since 3.6

e_source_selector_get_show_colors ()

gboolean            e_source_selector_get_show_colors   (ESourceSelector *selector);

Returns whether colors are shown next to data sources.

Since 3.6

e_source_selector_set_show_colors ()

void                e_source_selector_set_show_colors   (ESourceSelector *selector,
                                                         gboolean show_colors);

Sets whether to show colors next to data sources.

Since 3.6

e_source_selector_get_show_toggles ()

gboolean            e_source_selector_get_show_toggles  (ESourceSelector *selector);

Returns whether toggles are shown next to data sources.

Since 3.6

e_source_selector_set_show_toggles ()

void                e_source_selector_set_show_toggles  (ESourceSelector *selector,
                                                         gboolean show_toggles);

Sets whether to show toggles next to data sources.

Since 3.6

e_source_selector_select_source ()

void                e_source_selector_select_source     (ESourceSelector *selector,
                                                         ESource *source);

Select source in selector.

e_source_selector_unselect_source ()

void                e_source_selector_unselect_source   (ESourceSelector *selector,
                                                         ESource *source);

Unselect source in selector.

e_source_selector_select_exclusive ()

void                e_source_selector_select_exclusive  (ESourceSelector *selector,
                                                         ESource *source);

Select source in selector and unselect all others.

Since 2.30

e_source_selector_source_is_selected ()

gboolean            e_source_selector_source_is_selected
                                                        (ESourceSelector *selector,
                                                         ESource *source);

Check whether source is selected in selector.

e_source_selector_get_selection ()

GSList *            e_source_selector_get_selection     (ESourceSelector *selector);

Get the list of selected sources, i.e. those that were enabled through the corresponding checkboxes in the tree.

e_source_selector_free_selection ()

void                e_source_selector_free_selection    (GSList *list);

e_source_selector_set_select_new ()

void                e_source_selector_set_select_new    (ESourceSelector *selector,
                                                         gboolean state);

Set whether or not to select new sources added to selector.

e_source_selector_edit_primary_selection ()

void                e_source_selector_edit_primary_selection
                                                        (ESourceSelector *selector);

Allows the user to rename the primary selected source by opening an entry box directly in selector.

Since 2.26

e_source_selector_ref_primary_selection ()

ESource *           e_source_selector_ref_primary_selection
                                                        (ESourceSelector *selector);

Get the primary selected source. The primary selection is the one that is highlighted through the normal GtkTreeView selection mechanism (as opposed to the "normal" selection, which is the set of source whose checkboxes are checked).

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_selector_set_primary_selection ()

void                e_source_selector_set_primary_selection
                                                        (ESourceSelector *selector,
                                                         ESource *source);

Highlights source in selector. The highlighted ESource is called the primary selection.

Do not confuse this function with e_source_selector_select_source(), which activates the check box next to an ESource's display name in selector. This function does not alter the check box.

e_source_selector_ref_source_by_path ()

ESource *           e_source_selector_ref_source_by_path
                                                        (ESourceSelector *selector,
                                                         GtkTreePath *path);

Returns the ESource object at path, or NULL if path is invalid.

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_selector_queue_write ()

void                e_source_selector_queue_write       (ESourceSelector *selector,
                                                         ESource *source);

Queues a main loop idle callback to write changes to source back to the D-Bus registry service.

Since 3.6

The "extension-name" property

  "extension-name"           gchar*                : Read / Write / Construct Only

Default value: NULL

The "primary-selection" property

  "primary-selection"        ESource*              : Read / Write

The "registry" property

  "registry"                 ESourceRegistry*      : Read / Write / Construct Only

The "show-colors" property

  "show-colors"              gboolean              : Read / Write

Default value: TRUE

The "show-toggles" property

  "show-toggles"             gboolean              : Read / Write

Default value: TRUE

The "data-dropped" signal

gboolean            user_function                      (ESourceSelector  *esourceselector,
                                                        GtkSelectionData *arg1,
                                                        ESource          *arg2,
                                                        GdkDragAction     arg3,
                                                        guint             arg4,
                                                        gpointer          user_data)            : Run Last

The "popup-event" signal

gboolean            user_function                      (ESourceSelector *esourceselector,
                                                        GObject         *arg1,
                                                        GdkEvent        *arg2,
                                                        gpointer         user_data)            : Run Last

The "primary-selection-changed" signal

void                user_function                      (ESourceSelector *esourceselector,
                                                        gpointer         user_data)            : Run Last

The "selection-changed" signal

void                user_function                      (ESourceSelector *esourceselector,
                                                        gpointer         user_data)            : Run Last