## GeditPanel

GeditPanel

## Synopsis

                        GeditPanelPrivate;
                        GeditPanel;
    GtkWidget*          gedit_panel_new                     (GtkOrientation orientation);
    void                gedit_panel_add_item                (GeditPanel *panel,
                                                             GtkWidget *item,
                                                             const gchar *name,
                                                             GtkWidget *image);
    void                gedit_panel_add_item_with_stock_icon
                                                            (GeditPanel *panel,
                                                             GtkWidget *item,
                                                             const gchar *name,
                                                             const gchar *stock_id);
    gboolean            gedit_panel_remove_item             (GeditPanel *panel,
                                                             GtkWidget *item);
    gboolean            gedit_panel_activate_item           (GeditPanel *panel,
                                                             GtkWidget *item);
    gboolean            gedit_panel_item_is_active          (GeditPanel *panel,
                                                             GtkWidget *item);
    GtkOrientation      gedit_panel_get_orientation         (GeditPanel *panel);
    gint                gedit_panel_get_n_items             (GeditPanel *panel);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBox
                                     +----GtkVBox
                                           +----GeditPanel

## Implemented Interfaces

GeditPanel implements AtkImplementorIface and GtkBuildable.

## Properties

      "orientation"              GtkOrientation        : Read / Write / Construct Only

## Signals

      "close"                                          : Run Last / Action
      "focus-document"                                 : Run Last / Action
      "item-added"                                     : Run First
      "item-removed"                                   : Run First

## Description

## Details

### GeditPanelPrivate

    typedef struct _GeditPanelPrivate GeditPanelPrivate;

### GeditPanel

    typedef struct _GeditPanel GeditPanel;

### gedit_panel_new ()

    GtkWidget*          gedit_panel_new                     (GtkOrientation orientation);

Creates a new GeditPanel with the given `orientation`. You shouldn't create a new panel use `gedit_window_get_side_panel()` or `gedit_window_get_bottom_panel()` instead.

`orientation` : | a GtkOrientation
Returns : | a new GeditPanel object.

### gedit_panel_add_item ()

    void                gedit_panel_add_item                (GeditPanel *panel,
                                                             GtkWidget *item,
                                                             const gchar *name,
                                                             GtkWidget *image);

Adds a new item to the `panel`.

`panel` : | a GeditPanel
`item` : | the GtkWidget to add to the `panel`
`name` : | the name to be shown in the `panel`
`image` : | the image to be shown in the `panel`

### gedit_panel_add_item_with_stock_icon ()

    void                gedit_panel_add_item_with_stock_icon
                                                            (GeditPanel *panel,
                                                             GtkWidget *item,
                                                             const gchar *name,
                                                             const gchar *stock_id);

Same as `gedit_panel_add_item()` but using an image from stock.

`panel` : | a GeditPanel
`item` : | the GtkWidget to add to the `panel`
`name` : | the name to be shown in the `panel`
`stock_id` : | a stock id

### gedit_panel_remove_item ()

    gboolean            gedit_panel_remove_item             (GeditPanel *panel,
                                                             GtkWidget *item);

Removes the widget `item` from the panel if it is in the `panel` and returns TRUE if there was not any problem.

`panel` : | a GeditPanel
`item` : | the item to be removed from the panel
Returns : | TRUE if it was well removed.

### gedit_panel_activate_item ()

    gboolean            gedit_panel_activate_item           (GeditPanel *panel,
                                                             GtkWidget *item);

Switches to the page that contains `item`.

`panel` : | a GeditPanel
`item` : | the item to be activated
Returns : | TRUE if it was activated

### gedit_panel_item_is_active ()

    gboolean            gedit_panel_item_is_active          (GeditPanel *panel,
                                                             GtkWidget *item);

Wheter `item` is the one current active in `panel`

`panel` : | a GeditPanel
`item` : | a widget contained in GeditPanel
Returns : | TRUE if the widget is active

### gedit_panel_get_orientation ()

    GtkOrientation      gedit_panel_get_orientation         (GeditPanel *panel);

Gets the orientation of the `panel`.

`panel` : | a GeditPanel
Returns : | the GtkOrientation of GeditPanel

### gedit_panel_get_n_items ()

    gint                gedit_panel_get_n_items             (GeditPanel *panel);

Gets the number of items in a `panel`.

`panel` : | a GeditPanel
Returns : | the number of items contained in GeditPanel

## Property Details

### The `"orientation"` property

      "orientation"              GtkOrientation        : Read / Write / Construct Only

The panel's orientation.

Default value: GTK_ORIENTATION_VERTICAL

## Signal Details

### The `"close"` signal

    void                user_function                      (GeditPanel *geditpanel,
                                                            gpointer    user_data)       : Run Last / Action

`geditpanel` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.

### The `"focus-document"` signal

    void                user_function                      (GeditPanel *geditpanel,
                                                            gpointer    user_data)       : Run Last / Action

`geditpanel` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.

### The `"item-added"` signal

    void                user_function                      (GeditPanel *geditpanel,
                                                            GtkWidget  *widget,
                                                            gpointer    user_data)       : Run First

`geditpanel` : | the object which received the signal.
`widget` : |
`user_data` : | user data set when the signal handler was connected.

### The `"item-removed"` signal

    void                user_function                      (GeditPanel *geditpanel,
                                                            GtkWidget  *widget,
                                                            gpointer    user_data)       : Run First

`geditpanel` : | the object which received the signal.
`widget` : |
`user_data` : | user data set when the signal handler was connected.