## FmPlacesView FmPlacesView — A widget for side panel with places list. |

## Synopsis

    #define             FM_PLACES_VIEW_TYPE
    struct              FmPlacesView;
    struct              FmPlacesViewClass;
    void                fm_places_view_chdir                (FmPlacesView *pv,
                                                             FmPath *path);
    FmPlacesView *      fm_places_view_new                  (void);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkTreeView
                                     +----FmPlacesView

## Implemented Interfaces

FmPlacesView implements AtkImplementorIface and GtkBuildable.

## Properties

      "home-dir-path"            gchar*                : Read / Write

## Signals

      "chdir"                                          : Run Last
      "item-popup"                                     : Run Last

## Description

`include`: libfm/fm-gtk.h

The FmPlacesView displays list of pseudo-folders which contains such items as Home directory, Trash bin, mounted removable drives, bookmarks, etc.

## Details

### FM_PLACES_VIEW_TYPE

    #define FM_PLACES_VIEW_TYPE             (fm_places_view_get_type())

### struct FmPlacesView

    struct FmPlacesView;

### struct FmPlacesViewClass

    struct FmPlacesViewClass {
        GtkTreeViewClass parent_class;
        void (*chdir)(FmPlacesView* view, guint button, FmPath* path);
        void (*item_popup)(FmPlacesView* view, GtkUIManager* ui, GtkActionGroup* act_grp, FmFileInfo* file);
    };

GtkTreeViewClass `parent_class`; | the parent class
`chdir` () | the class closure for the "chdir" signal
`item_popup` () | the class closure for the "item-popup" signal

### fm_places_view_chdir ()

    void                fm_places_view_chdir                (FmPlacesView *pv,
                                                             FmPath *path);

Changes active path and eventually sends the "chdir" signal.

Before 1.0.0 this call had name fm_places_chdir. Before 0.1.12 this call had name fm_places_select.

`pv` : | a widget to apply
`path` : | the new path

Since 0.1.0

### fm_places_view_new ()

    FmPlacesView *      fm_places_view_new                  (void);

Creates new FmPlacesView widget.

Returns : | a new FmPlacesView object. [transfer full]

Since 0.1.0

## Property Details

### The `"home-dir-path"` property

      "home-dir-path"            gchar*                : Read / Write

The "home-dir-path" property defines which path will be used on Home item activation. Value of `NULL` resets it to the default.

Default value: "/root"

Since 1.2.0

## Signal Details

### The `"chdir"` signal

    void                user_function                      (FmPlacesView *view,
                                                            guint         button,
                                                            gpointer      path,
                                                            gpointer      user_data)      : Run Last

The "chdir" signal is emitted when current selected directory in view is changed.

`view` : | a view instance that emitted the signal
`button` : | the button row was activated with
`path` : | (FmPath *) new directory path
`user_data` : | user data set when the signal handler was connected.

Since 0.1.0

### The `"item-popup"` signal

    void                user_function                      (FmPlacesView *view,
                                                            GObject      *ui,
                                                            GObject      *act_grp,
                                                            gpointer      fi,
                                                            gpointer      user_data)      : Run Last

The "item-popup" signal is emitted when context menu is created for any directory in the view. Handler can modify the menu by adding or removing elements.

`view` : | a view instance that emitted the signal
`ui` : | the GtkUIManager using to create the menu
`act_grp` : | (GtkActionGroup *) the menu actions group
`fi` : | (FmFileInfo *) the item where menu popup is activated
`user_data` : | user data set when the signal handler was connected.

Since 1.2.0