## PeasGtkPluginManagerView PeasGtkPluginManagerView — Management tree view for plugins. |

## Synopsis

    struct              PeasGtkPluginManagerView;
    struct              PeasGtkPluginManagerViewClass;
    GtkWidget *         peas_gtk_plugin_manager_view_new    (PeasEngine *engine);
    void                peas_gtk_plugin_manager_view_set_show_builtin
                                                            (PeasGtkPluginManagerView *view,
                                                             gboolean show_builtin);
    gboolean            peas_gtk_plugin_manager_view_get_show_builtin
                                                            (PeasGtkPluginManagerView *view);
    void                peas_gtk_plugin_manager_view_set_selected_plugin
                                                            (PeasGtkPluginManagerView *view,
                                                             PeasPluginInfo *info);
    PeasPluginInfo *    peas_gtk_plugin_manager_view_get_selected_plugin
                                                            (PeasGtkPluginManagerView *view);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkWidget
                   +----GtkContainer
                         +----GtkTreeView
                               +----PeasGtkPluginManagerView

## Implemented Interfaces

PeasGtkPluginManagerView implements AtkImplementorIface, GtkBuildable and GtkScrollable.

## Properties

      "engine"                   PeasEngine*           : Read / Write / Construct Only
      "show-builtin"             gboolean              : Read / Write

## Signals

      "populate-popup"                                 : Run Last

## Description

The PeasGtkPluginManagerView is a tree view that can be used to manage plugins, i.e. load or unload them, and see some pieces of information.

The only thing you need to do as an application writer if you wish to use the view to display your plugins is to instantiate it using `peas_gtk_plugin_manager_view_new()` and pack it into another widget or a window.

Note: Changing the model of the view is not supported.

## Details

### struct PeasGtkPluginManagerView

    struct PeasGtkPluginManagerView;

The PeasGtkPluginManagerView structure contains only private data and should only be accessed using the provided API.

### struct PeasGtkPluginManagerViewClass

    struct PeasGtkPluginManagerViewClass {
      GtkTreeViewClass parent_class;

      void  (*populate_popup)   (PeasGtkPluginManagerView *view,
                                 GtkMenu                  *menu);
    };

The class structure for PeasGtkPluginManagerView.

GtkTreeViewClass `parent_class`; | The parent class.
`populate_popup` () | Signal class handler for the "populate-popup" signal.

### peas_gtk_plugin_manager_view_new ()

    GtkWidget *         peas_gtk_plugin_manager_view_new    (PeasEngine *engine);

Creates a new plugin manager view for the given PeasEngine.

If `engine` is `NULL`, then the default engine will be used.

`engine` : | A PeasEngine, or `NULL`. [allow-none]
Returns : | the new PeasGtkPluginManagerView.

### peas_gtk_plugin_manager_view_set_show_builtin ()

    void                peas_gtk_plugin_manager_view_set_show_builtin
                                                            (PeasGtkPluginManagerView *view,
                                                             gboolean show_builtin);

### Warning

`peas_gtk_plugin_manager_view_set_show_builtin` has been deprecated since version 1.2 and should not be used in newly-written code. Use hidden plugins instead.

Sets if builtin plugins should be shown.

`view` : | A PeasGtkPluginManagerView.
`show_builtin` : | If builtin plugins should be shown.

### peas_gtk_plugin_manager_view_get_show_builtin ()

    gboolean            peas_gtk_plugin_manager_view_get_show_builtin
                                                            (PeasGtkPluginManagerView *view);

### Warning

`peas_gtk_plugin_manager_view_get_show_builtin` has been deprecated since version 1.2 and should not be used in newly-written code. Use hidden plugins instead.

Returns if builtin plugins should be shown.

`view` : | A PeasGtkPluginManagerView.
Returns : | if builtin plugins should be shown.

### peas_gtk_plugin_manager_view_set_selected_plugin ()

    void                peas_gtk_plugin_manager_view_set_selected_plugin
                                                            (PeasGtkPluginManagerView *view,
                                                             PeasPluginInfo *info);

Selects the given plugin.

`view` : | A PeasGtkPluginManagerView.
`info` : | A PeasPluginInfo.

### peas_gtk_plugin_manager_view_get_selected_plugin ()

    PeasPluginInfo *    peas_gtk_plugin_manager_view_get_selected_plugin
                                                            (PeasGtkPluginManagerView *view);

Returns the currently selected plugin, or `NULL` if a plugin is not selected.

`view` : | A PeasGtkPluginManagerView.
Returns : | the selected plugin. [transfer none]

## Property Details

### The `"engine"` property

      "engine"                   PeasEngine*           : Read / Write / Construct Only

The PeasEngine this view is attached to.

### The `"show-builtin"` property

      "show-builtin"             gboolean              : Read / Write

### Warning

`PeasGtkPluginManagerView:show-builtin` has been deprecated since version 1.2 and should not be used in newly-written code. Use hidden plugins instead.

If builtin plugins should be shown.

Default value: FALSE

## Signal Details

### The `"populate-popup"` signal

    void                user_function                      (PeasGtkPluginManagerView *view,
                                                            GtkMenu                  *menu,
                                                            gpointer                  user_data)      : Run Last

The ::populate-popup signal is emitted before showing the context menu of the view. If you need to add items to the context menu, connect to this signal and add your menuitems to the `menu`.

`view` : | A PeasGtkPluginManagerView.
`menu` : | A GtkMenu.
`user_data` : | user data set when the signal handler was connected.