EphyToolbar

EphyToolbar — Epiphany's toolbar widget

Synopsis

                    EphyToolbar;
EphyToolbar *       ephy_toolbar_new                    (EphyWindow *window);
GtkActionGroup *    ephy_toolbar_get_action_group       (EphyToolbar *toolbar);
void                ephy_toolbar_set_favicon            (EphyToolbar *toolbar,
                                                         GdkPixbuf *icon);
void                ephy_toolbar_set_show_leave_fullscreen
                                                        (EphyToolbar *toolbar,
                                                         gboolean show);
void                ephy_toolbar_activate_location      (EphyToolbar *toolbar);
const char *        ephy_toolbar_get_location           (EphyToolbar *toolbar);
void                ephy_toolbar_set_location           (EphyToolbar *toolbar,
                                                         const char *address);
void                ephy_toolbar_set_navigation_actions (EphyToolbar *toolbar,
                                                         gboolean back,
                                                         gboolean forward,
                                                         gboolean up);
void                ephy_toolbar_set_navigation_tooltips
                                                        (EphyToolbar *toolbar,
                                                         const char *back_title,
                                                         const char *forward_title);
void                ephy_toolbar_set_security_state     (EphyToolbar *toolbar,
                                                         gboolean is_secure,
                                                         gboolean show_lock,
                                                         const char *stock_id,
                                                         const char *tooltip);
void                ephy_toolbar_set_spinning           (EphyToolbar *toolbar,
                                                         gboolean spinning);
void                ephy_toolbar_set_zoom               (EphyToolbar *toolbar,
                                                         gboolean can_zoom,
                                                         float zoom);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBox
                                 +----GtkVBox
                                       +----EggEditableToolbar
                                             +----EphyToolbar

Implemented Interfaces

EphyToolbar implements AtkImplementorIface, GtkBuildable, GtkOrientable and EphyLink.

Properties

  "window"                   EphyWindow*           : Write / Construct Only

Signals

  "activation-finished"                            : Run First
  "exit-clicked"                                   : Run First
  "lock-clicked"                                   : Run First

Description

EphyToolbar is a customized EggEditableToolbar.

Details

EphyToolbar

typedef struct _EphyToolbar EphyToolbar;


ephy_toolbar_new ()

EphyToolbar *       ephy_toolbar_new                    (EphyWindow *window);

Creates a new EphyToolbar and associates it with window.

window :

parent window for the toolbar

Returns :

a new EphyToolbar

ephy_toolbar_get_action_group ()

GtkActionGroup *    ephy_toolbar_get_action_group       (EphyToolbar *toolbar);

Gets the GtkActionGroup for toolbar.

toolbar :

an EphyToolbar widget

Returns :

. transfer none.

ephy_toolbar_set_favicon ()

void                ephy_toolbar_set_favicon            (EphyToolbar *toolbar,
                                                         GdkPixbuf *icon);

Sets icon to be the favicon of toolbar's internal EphyLocationEntry.

toolbar :

an EphyToolbar widget

icon :

a GdkPixbuf icon

ephy_toolbar_set_show_leave_fullscreen ()

void                ephy_toolbar_set_show_leave_fullscreen
                                                        (EphyToolbar *toolbar,
                                                         gboolean show);

Tells toolbar if it should show the leave fullscreen button or not.

toolbar :

an EphyToolbar widget

show :

TRUE to show the leave fullscreen button

ephy_toolbar_activate_location ()

void                ephy_toolbar_activate_location      (EphyToolbar *toolbar);

Calls ephy_location_entry_activate on toolbar's internal EphyLocationEntry.

toolbar :

an EphyToolbar widget

ephy_toolbar_get_location ()

const char *        ephy_toolbar_get_location           (EphyToolbar *toolbar);

Gets the current address according to toolbar's EphyLocationAction.

toolbar :

an EphyToolbar widget

Returns :

current toolbar address

ephy_toolbar_set_location ()

void                ephy_toolbar_set_location           (EphyToolbar *toolbar,
                                                         const char *address);

Sets the internal EphyLocationAction address to address.

toolbar :

an EphyToolbar widget

address :

new address

ephy_toolbar_set_navigation_actions ()

void                ephy_toolbar_set_navigation_actions (EphyToolbar *toolbar,
                                                         gboolean back,
                                                         gboolean forward,
                                                         gboolean up);

Sets the sensivity of navigation buttons in the toolbar.

toolbar :

an EphyToolbar widget

back :

TRUE if possible to go backward

forward :

TRUE if possible to go forward

up :

TRUE if possible to go up

ephy_toolbar_set_navigation_tooltips ()

void                ephy_toolbar_set_navigation_tooltips
                                                        (EphyToolbar *toolbar,
                                                         const char *back_title,
                                                         const char *forward_title);

Sets the titles of back and forward pages as the tooltips of its corresponding navigation buttons.

toolbar :

an EphyToolbar widget

back_title :

text for back button tooltip

forward_title :

text for forward button tooltip

ephy_toolbar_set_security_state ()

void                ephy_toolbar_set_security_state     (EphyToolbar *toolbar,
                                                         gboolean is_secure,
                                                         gboolean show_lock,
                                                         const char *stock_id,
                                                         const char *tooltip);

Sets properties on the lock icon inside the internal EphyLocationEntry.

toolbar :

an EphyToolbar widget

is_secure :

TRUE if the page is loaded over a secure connection

show_lock :

TRUE to show the lock icon in the location entry

stock_id :

stock-id to be used as the lock icon

tooltip :

tooltip for the lock icon

ephy_toolbar_set_spinning ()

void                ephy_toolbar_set_spinning           (EphyToolbar *toolbar,
                                                         gboolean spinning);

Controls the internal EphySpinner activity.

toolbar :

an EphyToolbar widget

spinning :

TRUE to set the internal EphySpinner as active

ephy_toolbar_set_zoom ()

void                ephy_toolbar_set_zoom               (EphyToolbar *toolbar,
                                                         gboolean can_zoom,
                                                         float zoom);

Sets the zoom level to zoom, but only if can_zoom is TRUE.

toolbar :

an EphyToolbar widget

can_zoom :

TRUE if the current EphyWebView can zoom

zoom :

new zoom level

Property Details

The "window" property

  "window"                   EphyWindow*           : Write / Construct Only

Parent window of the toolbar.

Signal Details

The "activation-finished" signal

void                user_function                      (EphyToolbar *toolbar,
                                                        gpointer     user_data)      : Run First

Emitted when the user clicks on the security icon of the internal EphyLocationEntry.

toolbar :

the object which received the signal.

user_data :

user data set when the signal handler was connected.

The "exit-clicked" signal

void                user_function                      (EphyToolbar *toolbar,
                                                        gpointer     user_data)      : Run First

Emitted when the user clicks on the security icon of the internal EphyLocationEntry.

toolbar :

the object which received the signal.

user_data :

user data set when the signal handler was connected.

The "lock-clicked" signal

void                user_function                      (EphyToolbar *toolbar,
                                                        gpointer     user_data)      : Run First

Emitted when the user clicks on the security icon of the internal EphyLocationEntry.

toolbar :

the object which received the signal.

user_data :

user data set when the signal handler was connected.