FmBookmarks

FmBookmarks — Bookmarks support for libfm.

Synopsis

#define             FM_BOOKMARKS_TYPE
struct              FmBookmarkItem;
struct              FmBookmarks;
struct              FmBookmarksClass;
#define             fm_bookmarks_append                 (bookmarks,
                                                         path,
                                                         name)
FmBookmarks *       fm_bookmarks_dup                    (void);
FmBookmarkItem *    fm_bookmarks_insert                 (FmBookmarks *bookmarks,
                                                         FmPath *path,
                                                         const char *name,
                                                         int pos);
const GList *       fm_bookmarks_list_all               (FmBookmarks *bookmarks);
void                fm_bookmarks_remove                 (FmBookmarks *bookmarks,
                                                         FmBookmarkItem *item);
void                fm_bookmarks_rename                 (FmBookmarks *bookmarks,
                                                         FmBookmarkItem *item,
                                                         const char *new_name);
void                fm_bookmarks_reorder                (FmBookmarks *bookmarks,
                                                         FmBookmarkItem *item,
                                                         int pos);

Object Hierarchy

  GObject
   +----FmBookmarks

Signals

  "changed"                                        : Run First

Description

include: libfm/fm-bookmarks.h

The application that uses libfm can use user-wide bookmark list via class FmBookmarks.

Details

FM_BOOKMARKS_TYPE

#define FM_BOOKMARKS_TYPE               (fm_bookmarks_get_type())

struct FmBookmarkItem

struct FmBookmarkItem {
    char* name;
    FmPath* path;
};

char *`name`;	display name of bookmark
FmPath *`path`;	path to bookmarked directory

struct FmBookmarks

struct FmBookmarks;

struct FmBookmarksClass

struct FmBookmarksClass {
    GObjectClass parent_class;
    void (*changed)(FmBookmarks*);
};

GObjectClass `parent_class`;	the parent class
`changed` ()	the class closure for "changed" signal

fm_bookmarks_append()

#define fm_bookmarks_append(bookmarks, path, name)  fm_bookmarks_insert(bookmarks, path, name, -1)

fm_bookmarks_dup ()

FmBookmarks *       fm_bookmarks_dup                    (void);

Returns reference to bookmarks list singleton descriptor.

Returns :

a reference to bookmarks list. [transfer full]

Since 0.1.99

fm_bookmarks_insert ()

FmBookmarkItem *    fm_bookmarks_insert                 (FmBookmarks *bookmarks,
                                                         FmPath *path,
                                                         const char *name,
                                                         int pos);

Adds a bookmark into bookmark list. Returned structure is managed by bookmarks list and should not be freed by caller.

`bookmarks` :	bookmarks list
`path` :	path requested to add to bookmarks
`name` :	name new bookmark will be seen in list with
`pos` :	where to insert a bookmark into list
Returns :	new created bookmark item. [transfer none]

Since 0.1.0

fm_bookmarks_list_all ()

const GList *       fm_bookmarks_list_all               (FmBookmarks *bookmarks);

Returns list of FmBookmarkItem retrieved from bookmarks list. Returned list is owned by bookmarks list and should not be freed by caller.

`bookmarks` :	bookmarks list
Returns :	(element-type FmBookmarkItem): list of bookmark items. [transfer none]

Since 0.1.0

fm_bookmarks_remove ()

void                fm_bookmarks_remove                 (FmBookmarks *bookmarks,
                                                         FmBookmarkItem *item);

Removes a bookmark from bookmark list.

`bookmarks` :	bookmarks list
`item` :	bookmark item for deletion

Since 0.1.0

fm_bookmarks_rename ()

void                fm_bookmarks_rename                 (FmBookmarks *bookmarks,
                                                         FmBookmarkItem *item,
                                                         const char *new_name);

Changes name of existing bookmark item.

`bookmarks` :	bookmarks list
`item` :	bookmark item which will be changed
`new_name` :	new name for bookmark item to be seen in list

Since 0.1.0

fm_bookmarks_reorder ()

void                fm_bookmarks_reorder                (FmBookmarks *bookmarks,
                                                         FmBookmarkItem *item,
                                                         int pos);

Changes position of existing bookmark item.

`bookmarks` :	bookmarks list
`item` :	bookmark item which will be changed
`pos` :	new position for bookmark item in list

Since 0.1.0

Signal Details

The `"changed"` signal

void                user_function                      (FmBookmarks *bookmarks,
                                                        gpointer     user_data)      : Run First

The "changed" signal is emitted when some bookmark item is changed, added, or removed.

`bookmarks` :	pointer to bookmarks list singleton descriptor
`user_data` :	user data set when the signal handler was connected.

Since 0.1.0

			Libfm Reference Manual
Top \| Description \| Object Hierarchy \| Signals