GarconMenuPrivate

typedef struct _GarconMenuPrivate GarconMenuPrivate;

garcon_menu_new ()

GarconMenu *        garcon_menu_new                     (GFile *file);

Creates a new GarconMenu for the .menu file referred to by file. This operation only fails file is invalid. To load the menu tree from the file, you need to call garcon_menu_load() with the returned GarconMenu.

The caller is responsible to destroy the returned GarconMenu using g_object_unref().

For more information about the usage see garcon_menu_new().

garcon_menu_new_for_path ()

GarconMenu *        garcon_menu_new_for_path            (const gchar *filename);

Creates a new GarconMenu for the .menu file referred to by filename. This operation only fails if the filename is NULL. To load the menu tree from the file, you need to call garcon_menu_load() with the returned GarconMenu.

GarconMenu *menu = garcon_menu_new (filename);

if (garcon_menu_load (menu, &error))
  ...
else
  ...

g_object_unref (menu);

The caller is responsible to destroy the returned GarconMenu using g_object_unref().

garcon_menu_new_applications ()

GarconMenu *        garcon_menu_new_applications        (void);

Creates a new GarconMenu for the applications.menu file which is being used to display installed applications.

For more information about the usage see garcon_menu_new().

garcon_menu_load ()

gboolean            garcon_menu_load                    (GarconMenu *menu,
                                                         GCancellable *cancellable,
                                                         GError **error);

This function loads the entire menu tree from the file referred to by menu. It resolves merges, moves and everything else defined in the menu specification. The resulting tree information is stored within menu and can be accessed using the public GarconMenu API afterwards.

cancellable can be used to handle blocking I/O when reading data from files during the loading process.

error should either be NULL or point to a GError return location where errors should be stored in.

garcon_menu_get_file ()

GFile *             garcon_menu_get_file                (GarconMenu *menu);

Get the file for menu. It refers to the .menu file from which menu was or will be loaded.

garcon_menu_get_directory ()

GarconMenuDirectory * garcon_menu_get_directory         (GarconMenu *menu);

Returns the GarconMenuDirectory of menu or NULL if the <Menu> element that corresponds to menu has no valid <Directory> element. The menu directory may contain a lot of useful information about the menu like the display and icon name, desktop environments it should show up in etc.

garcon_menu_get_menus ()

GList *             garcon_menu_get_menus               (GarconMenu *menu);

garcon_menu_add_menu ()

void                garcon_menu_add_menu                (GarconMenu *menu,
                                                         GarconMenu *submenu);

garcon_menu_get_menu_with_name ()

GarconMenu *        garcon_menu_get_menu_with_name      (GarconMenu *menu,
                                                         const gchar *name);

garcon_menu_get_parent ()

GarconMenu *        garcon_menu_get_parent              (GarconMenu *menu);

garcon_menu_get_item_pool ()

GarconMenuItemPool * garcon_menu_get_item_pool          (GarconMenu *menu);

garcon_menu_get_items ()

GList *             garcon_menu_get_items               (GarconMenu *menu);

Returns all GarconMenuItems included in menu. The items are sorted by their display names in ascending order.

The caller is responsible to free the returned list using

g_list_free (list);

when no longer needed.

garcon_menu_get_elements ()

GList *             garcon_menu_get_elements            (GarconMenu *menu);

GarconMenu

typedef struct _GarconMenu GarconMenu;

The "directory" property

  "directory"                GarconMenuDirectory*  : Read / Write

The directory entry associated with this menu.

The "file" property

  "file"                     GFile*                : Read / Write / Construct Only

The GFile from which the GarconMenu was loaded.