Top | ![]() |
![]() |
![]() |
![]() |
GtkWidget * | e_accounts_window_new () |
ESourceRegistry * | e_accounts_window_get_registry () |
void | e_accounts_window_show_with_parent () |
ESource * | e_accounts_window_ref_selected_source () |
void | e_accounts_window_select_source () |
void | e_accounts_window_insert_to_add_popup () |
GtkButtonBox * | e_accounts_window_get_button_box () |
gint | e_accounts_window_add_page () |
void | e_accounts_window_activate_page () |
gboolean | add-source | Action |
gboolean | delete-source | Action |
gboolean | edit-source | Action |
void | enabled-toggled | Run Last |
gboolean | get-editing-flags | Action |
void | populate-add-popup | Run Last |
void | selection-changed | Run Last |
GObject ╰── GInitiallyUnowned ╰── GtkWidget ╰── GtkContainer ╰── GtkBin ╰── GtkWindow ╰── EAccountsWindow
EAccountsWindow implements AtkImplementorIface, GtkBuildable and EExtensible.
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.
GtkWidget *
e_accounts_window_new (ESourceRegistry *registry
);
Creates a new EAccountsWindow instance.
Since: 3.26
ESourceRegistry *
e_accounts_window_get_registry (EAccountsWindow *accounts_window
);
Returns the ESourceRegistry passed to e_accounts_window_new()
.
Since: 3.26
void e_accounts_window_show_with_parent (EAccountsWindow *accounts_window
,GtkWindow *parent
);
Shows the accounts_window
on top of the parent
, if not NULL
.
accounts_window |
||
parent |
a GtkWindow, parent to show the |
[nullable] |
Since: 3.26
ESource *
e_accounts_window_ref_selected_source (EAccountsWindow *accounts_window
);
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
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.
Since: 3.28
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.
accounts_window |
||
popup_menu |
a GtkMenuShell |
|
kind |
item kind, or |
[nullable] |
label |
item label, possibly with a mnemonic |
|
icon_name |
optional icon name to use for the menu item, or |
[nullable] |
Since: 3.26
GtkButtonBox *
e_accounts_window_get_button_box (EAccountsWindow *accounts_window
);
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
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.
Since: 3.26
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.
Since: 3.26
struct EAccountsWindow;
Contains only private data that should be read and manipulated using the functions below.
Since: 3.26
“registry”
property “registry” ESourceRegistry *
The ESourceRegistry manages ESource instances.
Owner: EAccountsWindow
Flags: Read / Write / Construct Only
Since: 3.26
“add-source”
signalgboolean user_function (EAccountsWindow *kind, char *Returns, gpointer user_data)
Emitted to add (create) a new ESource of the given kind. The extensions can listen
to this signal and can step in and add the source with the appropriate editing dialog.
Such extension also returns TRUE
, to stop signal emission.
If the extension cannot work with the given kind
, then it returns FALSE
.
Currently known kinds are "collection", "mail", "book", "calendar", "memo-list" and
"task-list". Extensions can add their own kinds with e_accounts_window_insert_to_add_popup()
from EAccountsWindow::populate-add-popup signal.
kind |
a UTF-8 string of the kind of source to create |
|
user_data |
user data set when the signal handler was connected. |
Flags: Action
Since: 3.26
“delete-source”
signalgboolean user_function (EAccountsWindow *source, ESource *Returns, gpointer user_data)
Emitted to delete the given source
. The extensions listen to this signal and
the one which also set “get-edit-flags” for this source
will remove the source. It also returns TRUE
, to stop signal emission.
If the extension cannot work with the given source
, then it returns FALSE
.
Flags: Action
Since: 3.26
“edit-source”
signalgboolean user_function (EAccountsWindow *source, ESource *Returns, gpointer user_data)
Emitted to edit the given source
. The extensions listen to this signal and
the one which also set “get-edit-flags” for this source
will open appropriate editing dialog. It also returns TRUE
, to stop signal emission.
If the extension cannot work with the given source
, then it returns FALSE
.
Flags: Action
Since: 3.26
“enabled-toggled”
signalvoid user_function (EAccountsWindow *source, ESource *arg1, gpointer user_data)
Emitted after source
-s enable property had been toggled in the tree view.
Flags: Run Last
Since: 3.26
“get-editing-flags”
signalgboolean user_function (EAccountsWindow *source, ESource *out_flags, gpointer Returns, gpointer user_data)
Emitted to get editing flags for the given source
. The extensions listen
to this signal and the one which can handle this source
sets out_flags
appropriately. It also returns TRUE
, to stop signal emission. If the extension
cannot work with the given source
, then it simply returns FALSE
.
source |
an ESource |
|
out_flags |
bit-or of ESourceEditingFlags. |
[out] |
user_data |
user data set when the signal handler was connected. |
Flags: Action
Since: 3.26
“populate-add-popup”
signalvoid user_function (EAccountsWindow *popup_menu, GtkMenuShell *arg1, gpointer user_data)
Emitted before Add popup is shown. It is already populated with default
source types. The signal listener can use e_accounts_window_insert_to_add_popup()
to add items to it.
popup_menu |
a GtkMenuShell, the popup menu |
|
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 3.26
“selection-changed”
signalvoid user_function (EAccountsWindow *source, ESource *arg1, gpointer user_data)
Emitted after selection in the account tree view change. The source
is the selected ESource,
but can be NULL
, when the selected row has no associated ESource, or nothing is selected.
source |
an ESource, or |
[nullable] |
user_data |
user data set when the signal handler was connected. |
Flags: Run Last
Since: 3.26