EphyStatusbar 3 EPIPHANY Library
EphyStatusbar A statusbar widget for Epiphany

## Synopsis

                        EphyStatusbar;
    GtkWidget *         ephy_statusbar_new                  (void);
    GtkWidget *         ephy_statusbar_get_security_frame   (EphyStatusbar *statusbar);
    void                ephy_statusbar_set_caret_mode       (EphyStatusbar *statusbar,
                                                             gboolean enabled);
    void                ephy_statusbar_set_security_state   (EphyStatusbar *statusbar,
                                                             const char *stock_id,
                                                             const char *tooltip);
    void                ephy_statusbar_set_popups_state     (EphyStatusbar *statusbar,
                                                             gboolean hidden,
                                                             const char *tooltip);
    void                ephy_statusbar_add_widget           (EphyStatusbar *statusbar,
                                                             GtkWidget *widget);
    void                ephy_statusbar_remove_widget        (EphyStatusbar *statusbar,
                                                             GtkWidget *widget);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBox
                                     +----GtkHBox
                                           +----GtkStatusbar
                                                 +----EphyStatusbar

## Implemented Interfaces

EphyStatusbar implements AtkImplementorIface, GtkBuildable and GtkOrientable.

## Signals

      "lock-clicked"                                   : Run Last / Action

## Description

EphyStatusbar is Epiphany's default statusbar for all windows.

## Details

### EphyStatusbar

    typedef struct _EphyStatusbar EphyStatusbar;

EphyStatusbar

### ephy_statusbar_new ()

    GtkWidget *         ephy_statusbar_new                  (void);

Creates a new EphyStatusbar.

Returns :

  the new EphyStatusbar object

ephy_statusbar_new

### ephy_statusbar_get_security_frame ()

    GtkWidget *         ephy_statusbar_get_security_frame   (EphyStatusbar *statusbar);

statusbar :

  an EphyStatusbar

Returns :

  the statusbar's lock icon frame. [transfer none]

ephy_statusbar_get_security_frame

### ephy_statusbar_set_caret_mode ()

    void                ephy_statusbar_set_caret_mode       (EphyStatusbar *statusbar,
                                                             gboolean enabled);

Sets the statusbar's caret browsing mode indicator.

statusbar :

  an EphyStatusbar

enabled :

  `TRUE` to show the caret browsing mode indicator

ephy_statusbar_set_caret_mode

### ephy_statusbar_set_security_state ()

    void                ephy_statusbar_set_security_state   (EphyStatusbar *statusbar,
                                                             const char *stock_id,
                                                             const char *tooltip);

Sets the statusbar's security icon and its tooltip.

statusbar :

  an EphyStatusbar

stock_id :

  stock-id of the icon showing the security state

tooltip :

  a string detailing the security state

ephy_statusbar_set_security_state

### ephy_statusbar_set_popups_state ()

    void                ephy_statusbar_set_popups_state     (EphyStatusbar *statusbar,
                                                             gboolean hidden,
                                                             const char *tooltip);

Sets the statusbar's popup-blocker icon's tooltip and visibility.

statusbar :

  an EphyStatusbar

hidden :

  `TRUE` if popups have been hidden

tooltip :

  a string to display as tooltip, or `NULL`

ephy_statusbar_set_popups_state

### ephy_statusbar_add_widget ()

    void                ephy_statusbar_add_widget           (EphyStatusbar *statusbar,
                                                             GtkWidget *widget);

Adds the widget to the statusbar. Use this function whenever you want to add a widget to the statusbar. You can remove the widget again with `ephy_statusbar_remove_widget()`.

statusbar :

  an EphyStatusbar

widget :

  a GtkWidget

ephy_statusbar_add_widget

### ephy_statusbar_remove_widget ()

    void                ephy_statusbar_remove_widget        (EphyStatusbar *statusbar,
                                                             GtkWidget *widget);

Removes widget, which must have been added to statusbar using `ephy_statusbar_add_widget()`.

statusbar :

  an EphyStatusbar

widget :

  a GtkWidget

ephy_statusbar_remove_widget

## Signal Details

### The `"lock-clicked"` signal

    void                user_function                      (EphyStatusbar *statusbar,
                                                            gpointer       user_data)      : Run Last / Action

This signal corresponds to the user clicking on the lock icon on the statusbar.

statusbar :

  the object which received the signal.

user_data :

  user data set when the signal handler was connected.

EphyStatusbar::lock-clicked