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().

[constructor]

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.

1
2
3
4
5
6
7
8

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().

[constructor]

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.

The returned object should be unreffed with g_object_unref() when no longer needed.

garcon_menu_get_directory ()

GarconMenuDirectory *
garcon_menu_get_directory (GarconMenu *menu);

Returns the GarconMenuDirectory of menu or NULL if menu has no valid directory element.

The returned object should be unreffed with g_object_unref() when no longer needed.

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);

Returns a sorted list of GarconMenu submenus of menu . The list should be freed with g_list_free().

garcon_menu_add_menu ()

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

Adds submenu as a sub menu to menu .

garcon_menu_get_menu_with_name ()

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

Looks in menu for a submenu with name as name.

garcon_menu_get_parent ()

GarconMenu *
garcon_menu_get_parent (GarconMenu *menu);

Returns the parent GarconMenu or menu .

garcon_menu_get_item_pool ()

GarconMenuItemPool *
garcon_menu_get_item_pool (GarconMenu *menu);

Get the item pool of the menu. This pool contains all items in this menu (for that of its submenus).

garcon_menu_get_items ()

GList *
garcon_menu_get_items (GarconMenu *menu);

Returns all GarconMenuItem 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() when no longer needed.

garcon_menu_get_elements ()

GList *
garcon_menu_get_elements (GarconMenu *menu);

Get all the menu element in menu . This contains sub menus, menu items and separators.

Returns a list of GarconMenuItem or NULL. Free the list with g_list_free().

The “directory” property

  “directory”                GarconMenuDirectory *

The directory entry associated with this menu.

Owner: GarconMenu

Flags: Read / Write

The “file” property

  “file”                     GFile *

The GFile from which the GarconMenu was loaded.

Owner: GarconMenu

Flags: Read / Write / Construct Only

The “directory-changed” signal

void
user_function (GarconMenu          *garconmenu,
               GarconMenuDirectory *arg1,
               GarconMenuDirectory *arg2,
               gpointer             user_data)

Flags: No Hooks

The “reload-required” signal

void
user_function (GarconMenu *garconmenu,
               gpointer    user_data)

Flags: No Hooks