EShellSwitcher

EShellSwitcher — buttons for switching views

Synopsis

#include <shell/e-shell-switcher.h>

struct              EShellSwitcher;
GtkWidget *         e_shell_switcher_new                (void);
void                e_shell_switcher_add_action         (EShellSwitcher *switcher,
                                                         GtkAction *switch_action,
                                                         GtkAction *new_window_action);
GtkToolbarStyle     e_shell_switcher_get_style          (EShellSwitcher *switcher);
void                e_shell_switcher_set_style          (EShellSwitcher *switcher,
                                                         GtkToolbarStyle style);
void                e_shell_switcher_unset_style        (EShellSwitcher *switcher);
gboolean            e_shell_switcher_get_visible        (EShellSwitcher *switcher);
void                e_shell_switcher_set_visible        (EShellSwitcher *switcher,
                                                         gboolean visible);

Description

Details

struct EShellSwitcher

struct EShellSwitcher {
	GtkBin parent;
	EShellSwitcherPrivate *priv;
};

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


e_shell_switcher_new ()

GtkWidget *         e_shell_switcher_new                (void);

Creates a new EShellSwitcher instance.

Returns :

a new EShellSwitcher instance

e_shell_switcher_add_action ()

void                e_shell_switcher_add_action         (EShellSwitcher *switcher,
                                                         GtkAction *switch_action,
                                                         GtkAction *new_window_action);

Adds a button to switcher that proxies for switcher_action. Switcher buttons appear in the order they were added. A middle click opens a new window of this type.

EShellWindow adds switcher actions in the order given by the sort_order field in EShellBackendClass.

switcher :

an EShellSwitcher

switch_action :

a GtkAction

new_window_action :

a GtkAction

e_shell_switcher_get_style ()

GtkToolbarStyle     e_shell_switcher_get_style          (EShellSwitcher *switcher);

Returns whether switcher has text, icons or both.

switcher :

an EShellSwitcher

Returns :

the current style of shell

e_shell_switcher_set_style ()

void                e_shell_switcher_set_style          (EShellSwitcher *switcher,
                                                         GtkToolbarStyle style);

Alters the view of switcher to display either icons only, text only, or both.

switcher :

an EShellSwitcher

style :

the new style for switcher

e_shell_switcher_unset_style ()

void                e_shell_switcher_unset_style        (EShellSwitcher *switcher);

Unsets a switcher style set with e_shell_switcher_set_style(), so that user preferences will be used to determine the switcher style.

switcher :

an EShellSwitcher

e_shell_switcher_get_visible ()

gboolean            e_shell_switcher_get_visible        (EShellSwitcher *switcher);

Returns TRUE if the switcher buttons are visible.

Note that switcher button visibility is different than switcher's GTK_VISIBLE flag, since EShellSwitcher is actually a container widget for EShellSidebar.

switcher :

an EShellSwitcher

Returns :

TRUE if the switcher buttons are visible

e_shell_switcher_set_visible ()

void                e_shell_switcher_set_visible        (EShellSwitcher *switcher,
                                                         gboolean visible);

Sets the switcher button visiblity to visible.

Note that switcher button visibility is different than switcher's GTK_VISIBLE flag, since EShellSwitcher is actually a container widget for EShellSidebar.

switcher :

an EShellSwitcher

visible :

whether the switcher buttons should be visible