EAccountsWindow

EAccountsWindow — Accounts Window

Functions

Types and Values

Includes

#include <e-util/e-util.h>

Description

EAccountsWindow shows all configured accounts in evolution-data-server and allows also create new, modify or remove existing accounts as well. It's extensible through EExtension, thus it can be taught how to work with particular account types as well.

Functions

e_accounts_window_new ()

GtkWidget *
e_accounts_window_new (ESourceRegistry *registry);

Creates a new EAccountsWindow instance.

Parameters

registry

an ESourceRegistry

 

Returns

an EAccountsWindow as a GtkWidget.

[transfer full]

Since: 3.26


e_accounts_window_get_registry ()

ESourceRegistry *
e_accounts_window_get_registry (EAccountsWindow *accounts_window);

Returns the ESourceRegistry passed to e_accounts_window_new().

Parameters

accounts_window

an EAccountsWindow

 

Returns

an ESourceRegistry.

[transfer none]

Since: 3.26


e_accounts_window_show_with_parent ()

void
e_accounts_window_show_with_parent (EAccountsWindow *accounts_window,
                                    GtkWindow *parent);

Shows the accounts_window on top of the parent , if not NULL.

Parameters

accounts_window

an EAccountsWindow

 

parent

a GtkWindow, parent to show the accounts_window on top of, or NULL.

[nullable]

Since: 3.26


e_accounts_window_ref_selected_source ()

ESource *
e_accounts_window_ref_selected_source (EAccountsWindow *accounts_window);

Parameters

accounts_window

an EAccountsWindow

 

Returns

Referenced selected ESource, which should be unreffed with g_object_unref(), when no longer needed, or NULL, when there is no source selected.

[nullable][transfer full]

Since: 3.26


e_accounts_window_select_source ()

void
e_accounts_window_select_source (EAccountsWindow *accounts_window,
                                 const gchar *uid);

Selects an ESource with the given uid . If no such is available in time of this call, then it is remembered and selected once it appears. The function doesn't change selection, when uid is NULL, but it unsets remembered UID from any previous call.

Parameters

accounts_window

an EAccountsWindow

 

uid

an ESource UID to select.

[nullable]

Since: 3.28


e_accounts_window_insert_to_add_popup ()

void
e_accounts_window_insert_to_add_popup (EAccountsWindow *accounts_window,
                                       GtkMenuShell *popup_menu,
                                       const gchar *kind,
                                       const gchar *label,
                                       const gchar *icon_name);

Adds a new item into the popup_menu , which will be labeled with label . Items added this way are executed with EAccountsWindow::add-source signal.

Special case "-" can be used for the label to add a separator. In that case the kind and the icon_name parameters are ignored.

Parameters

accounts_window

an EAccountsWindow

 

popup_menu

a GtkMenuShell

 

kind

item kind, or NULL, when label is "-".

[nullable]

label

item label, possibly with a mnemonic

 

icon_name

optional icon name to use for the menu item, or NULL.

[nullable]

Since: 3.26


e_accounts_window_get_button_box ()

GtkButtonBox *
e_accounts_window_get_button_box (EAccountsWindow *accounts_window);

Parameters

accounts_window

an EAccountsWindow

 

Returns

the button box of the main page, where action buttons are stored. It can be used to add other actions to it.

[transfer none]

Since: 3.26


e_accounts_window_add_page ()

gint
e_accounts_window_add_page (EAccountsWindow *accounts_window,
                            GtkWidget *content);

Adds a new hidden page to the account window with content content . The returned integer is the index of the added page, which can be used with e_accounts_window_activate_page() to make that page active.

Parameters

accounts_window

an EAccountsWindow

 

content

a GtkWidget, the page content

 

Returns

index of the added page, or -1 on error.

Since: 3.26


e_accounts_window_activate_page ()

void
e_accounts_window_activate_page (EAccountsWindow *accounts_window,
                                 gint page_index);

Activates certain page in the accounts_window . The page_index should be the one returned by e_accounts_window_add_page(). Using value out of bounds selects the main page, which shows listing of configured accounts.

Parameters

accounts_window

an EAccountsWindow

 

page_index

an index of the page to activate

 

Since: 3.26

Types and Values

enum ESourceEditingFlags

Members

E_SOURCE_EDITING_FLAG_NONE

   

E_SOURCE_EDITING_FLAG_CAN_ENABLE

   

E_SOURCE_EDITING_FLAG_CAN_EDIT

   

E_SOURCE_EDITING_FLAG_CAN_DELETE

   

struct EAccountsWindow

struct EAccountsWindow {
	GtkWindow parent;
	EAccountsWindowPrivate *priv;
};

Contains only private data that should be read and manipulated using the functions below.

Since: 3.26