Top | ![]() |
![]() |
![]() |
![]() |
GtkWidget * e_shell_window_new (EShell *shell
,,
gboolean safe_modeconst
);gchar *geometry
Returns a new EShellWindow.
It's up to the various EShellView's to define exactly what "safe mode" means, but the EShell usually puts the initial EShellWindow into "safe mode" if detects the previous Evolution session crashed.
The initial view for the window is determined by GSettings key
/org/gnome/evolution/shell/default-component-id
.
Or, if the GSettings key is not set or can't be read, the first view
in the switcher is used.
shell |
an EShell |
|
safe_mode |
whether to initialize the window to "safe mode" |
|
geometry |
initial window geometry string, or |
EShell *
e_shell_window_get_shell (EShellWindow *shell_window
);
Returns the EShell that was passed to e_shell_window_new()
.
gboolean e_shell_window_is_main_instance (EShellWindow *shell_window
);
Returns, whether the shell_window
is the main instance, which is
the window which was created as the first shell_window
.
struct _EShellView * e_shell_window_get_shell_view (EShellWindow *shell_window
,const
);gchar *view_name
Returns the EShellView named view_name
(see the
name
field in e_shell_window_get_active_view()
,
should be requested.
The function emits a view_name
as the signal detail when it instantiates an EShellView.
struct _EShellView * e_shell_window_peek_shell_view (EShellWindow *shell_window
,const
);gchar *view_name
Returns the EShellView named view_name
(see the
name
field in NULL
e_shell_window_get_shell_view()
, this function will not instantiate
the view itself.
GtkAction * e_shell_window_get_shell_view_action (EShellWindow *shell_window
,const
);gchar *view_name
Returns the switcher action for view_name
.
An EShellWindow creates a view_name
is active, the action's icon becomes the shell_window
icon.
the switcher action for the EShellView named view_name
,
or NULL
GtkWidget * e_shell_window_get_alert_bar (EShellWindow *shell_window
);
Returns the
EFocusTracker * e_shell_window_get_focus_tracker (EShellWindow *shell_window
);
Returns shell_window
's focus tracker, which directs
Cut, Copy, Paste and Select All main menu activations to the
appropriate editable or selectable widget.
GtkUIManager * e_shell_window_get_ui_manager (EShellWindow *shell_window
);
Returns shell_window
's user interface manager, which
manages the window's menus and toolbars via
GtkAction * e_shell_window_get_action (EShellWindow *shell_window
,const
);gchar *action_name
Returns the action_name
in shell_window
's
user interface manager, or NULL
GtkActionGroup * e_shell_window_get_action_group (EShellWindow *shell_window
,const
);gchar *group_name
Returns the group_name
in
shell_window
's user interface manager, or NULL
GtkWidget * e_shell_window_get_managed_widget (EShellWindow *shell_window
,const
);gchar *widget_path
Looks up a widget in shell_window
's user interface manager by
following a path. See gtk_ui_manager_get_widget()
constgchar * e_shell_window_get_active_view (EShellWindow *shell_window
);
Returns the name of the active EShellView.
void e_shell_window_set_active_view (EShellWindow *shell_window
,const
);gchar *view_name
Switches shell_window
to the EShellView named view_name
, causing
the entire content of shell_window
to change. This is typically
called as a result of the user clicking one of the switcher buttons.
The name of the newly activated shell view is also written to GSettings key
/org/gnome/evolution/shell/default-component-id
.
This makes the active shell view persistent across Evolution sessions.
It also causes new shell windows created within the current Evolution
session to open to the most recently selected shell view.
gboolean e_shell_window_get_safe_mode (EShellWindow *shell_window
);
Returns TRUE
shell_window
is in "safe mode".
It's up to the various EShellView's to define exactly
what "safe mode" means. The shell_window
simply manages the
"safe mode" state.
void e_shell_window_set_safe_mode (EShellWindow *shell_window
,);
gboolean safe_mode
If TRUE
shell_window
into "safe mode".
It's up to the various EShellView's to define exactly
what "safe mode" means. The shell_window
simply manages the
"safe mode" state.
void e_shell_window_add_action_group (EShellWindow *shell_window
,const
);gchar *group_name
Creates a new shell_window
's
user interface manager. This also takes care of details like setting
the translation domain.
gboolean e_shell_window_get_menubar_visible (EShellWindow *shell_window
);
Returns TRUE
shell_window
's menu bar is visible.
Since: 3.24
void e_shell_window_set_menubar_visible (EShellWindow *shell_window
,);
gboolean menubar_visible
Makes shell_window
's menu bar visible or invisible.
Since: 3.24
gboolean e_shell_window_get_sidebar_visible (EShellWindow *shell_window
);
Returns TRUE
shell_window
's side bar is visible.
void e_shell_window_set_sidebar_visible (EShellWindow *shell_window
,);
gboolean sidebar_visible
Makes shell_window
's side bar visible or invisible.
gboolean e_shell_window_get_switcher_visible (EShellWindow *shell_window
);
Returns TRUE
shell_window
's switcher buttons are visible.
void e_shell_window_set_switcher_visible (EShellWindow *shell_window
,);
gboolean switcher_visible
Makes shell_window
's switcher buttons visible or invisible.
shell_window |
an EShellWindow |
|
switcher_visible |
whether the switcher buttons should be visible |
gboolean e_shell_window_get_taskbar_visible (EShellWindow *shell_window
);
Returns TRUE
shell_window
's task bar is visible.
void e_shell_window_set_taskbar_visible (EShellWindow *shell_window
,);
gboolean taskbar_visible
Makes shell_window
's task bar visible or invisible.
gboolean e_shell_window_get_toolbar_visible (EShellWindow *shell_window
);
Returns TRUE
shell_window
's tool bar is visible.
void e_shell_window_set_toolbar_visible (EShellWindow *shell_window
,);
gboolean toolbar_visible
Makes shell_window
's tool bar visible or invisible.
void (*EShellWindowConnetClientFunc) (EShellWindow *shell_window
,,
EClient *client);
gpointer user_data
void e_shell_window_connect_client (EShellWindow *shell_window
,,
ESource *sourceconst
,gchar *extension_nameEShellWindowConnetClientFunc connected_cb
,,
gpointer user_data);
GDestroyNotify destroy_user_data
Get's an connected_cb
is called in the main thread,
but only when the operation succeeded. Any failure is propageted to UI.
shell_window |
an EShellWindow |
|
source |
an |
|
extension_name |
an extension name |
|
connected_cb |
a callback to be called when the client is opened |
|
user_data |
a user data passed to |
|
destroy_user_data |
callback to free |
[allow none] |
Since: 3.16
void e_shell_window_register_new_item_actions (EShellWindow *shell_window
,const
,gchar *backend_name,
GtkActionEntry *entries);
guint n_entries
Registers a list of shell_window
's "New" menu and toolbar button. This
function should be called from an EShell's
backend_name
argument (i.e. the name
field from its own
The registered NC_()
shell_window |
an EShellWindow |
|
backend_name |
name of an EShellBackend |
|
entries |
an array of |
|
n_entries |
number of elements in the array |
void e_shell_window_register_new_source_actions (EShellWindow *shell_window
,const
,gchar *backend_name,
GtkActionEntry *entries);
guint n_entries
Registers a list of shell_window
's "New" menu and toolbar button. This
function should be called from an EShell's
backend_name
argument (i.e. the name
field from its own
The registered NC_()
shell_window |
an EShellWindow |
|
backend_name |
name of an EShellBackend |
|
entries |
an array of |
|
n_entries |
number of elements in the array |