Macro for garcon_set_environment or garcon_set_environment_xdg to set the Xfce Desktop Environment. Creates a new #GarconMenu for the .menu file referred to by @file. This operation only fails if @file is invalid. To load the menu tree from the file, you need to call garcon_menu_load() with the returned #GarconMenu. <informalexample><programlisting> GarconMenu *menu = garcon_menu_new (filename); if (garcon_menu_load (menu, &error)) ... else ... g_object_unref (menu); </programlisting></informalexample> The caller is responsible to destroy the returned #GarconMenu using g_object_unref(). For more information about the usage @see garcon_menu_new(). a new #GarconMenu. #GFile for the .menu file you want to load. 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(). a new #GarconMenu for applications.menu. 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. The caller is responsible to destroy the returned #GarconMenu using g_object_unref(). a new #GarconMenu for @filename. Path/URI of the .menu file you want to load. Adds @submenu as a sub menu to @menu. a #GarconMenu a #GarconMenu Returns the #GarconMenuDirectory of @menu or %NULL if @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. a #GarconMenuDirectory a #GarconMenu. 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(). a #GarconMenu. 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. a #GFile. a #GarconMenu. Get the item pool of the menu. This pool contains all items in this menu (for that of its submenus). a #GarconMenuItemPool. a #GarconMenu. 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. list of #GarconMenuItem included in @menu. a #GarconMenu. Looks in @menu for a submenu with @name as name. a #GarconMenu or %NULL. a #GarconMenu a sub menu name Returns a sorted list of #GarconMenu submenus of @menu. The list should be freed with g_list_free(). a sorted list of #GarconMenu. a #GarconMenu Returns the parent #GarconMenu or @menu. a #GarconMenu or %NULL if @menu is the root menu. a #GarconMenu 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. %TRUE if the menu was loaded successfully or %FALSE if there was an error or the process was cancelled. a #GarconMenu a #GCancellable The directory entry associated with this menu. The #GFile from which the %GarconMenu was loaded. Create a new #GarconMenuDirectory for @file. You most likely never use this, but retrieve the info from garcon_menu_get_directory(). a #GarconMenuDirectory. a #GFile Checks if both directories point to the same file. if files are equal %TRUE, else %FALSE. a #GarconMenuDirectory a #GarconMenuDirectory Get the comment of @directory. a the description for @directory. a #GarconMenuDirectory Get the #GFile for @directory. The returned object should be unreffed with g_object_unref() when no longer needed. a #GFile a #GarconMenuDirectory Whether @directory should be hidden. For applications you want to call garcon_menu_directory_get_visible(). a the hidden key for @directory. a #GarconMenuDirectory Get the icon name of @directory. a the icon-name key for @directory. a #GarconMenuDirectory Get the name of @directory. a the name for @directory. a #GarconMenuDirectory Whether @directory should be displayed. For applications you want to call garcon_menu_directory_get_visible(). a the no-display key for @directory. a #GarconMenuDirectory Whether @directory is visible in the current environment which has been set by garcon_set_environment(). For applications you want to call garcon_menu_directory_get_visible(). %TRUE is visible in environment, else %FALSE. a #GarconMenuDirectory Check which runs the following checks: garcon_menu_directory_get_show_in_environment(), garcon_menu_directory_get_hidden() and garcon_menu_directory_get_no_display(). if visible %TRUE, else %FALSE. a #GarconMenuDirectory Set the comment of @directory. a #GarconMenuDirectory the new description for @directory. Set the icon name of @directory. a #GarconMenuDirectory the new icon name for @directory. Set the name of @directory. a #GarconMenuDirectory the new name for @directory. Set the NoDisplay key of @directory. a #GarconMenuDirectory whether @directory should be displayed. Directory description (comment). Icon associated with this directory. Name of the directory. Whether this menu item is hidden in menus. Returns (transfer full): a new #GarconMenuItem a #GFile a new #GarconMenuItem name of a file a new #GarconMenuItem a given URI a #GarconMenuItemAction a #GarconMenuItem list of action name a #GarconMenuItem Returns list of categories a #GarconMenuItem Get the #GFile for @item. The returned object should be unreffed with g_object_unref() when no longer needed. a #GFile. A #GarconMenuItem a #GarconMenuItem a #GarconMenuItem list of categories a #GarconMenuItem list of keywords Command to be executed when the menu item is clicked. Comment/description for the application. To be displayed e.g. in tooltips of GtkMenuItems. The desktop-file id of this application. The #GFile from which the %GarconMenuItem was loaded. GenericName of the application (will be displayed in menus etc.). It means the user deleted (at his level) something that was present (at an upper level, e.g. in the system dirs). It's strictly equivalent to the .desktop file not existing at all, as far as that user is concerned. Name of the icon to be displayed for this menu item. Name of the application (will be displayed in menus etc.). Whether this menu item is hidden in menus. Working directory the application should be started in. If true, the application prefers to be run on a more powerful discrete GPU if available. Whether this application requires a terinal to be started in. Path to an executable file on disk used to determine if the program is actually installed. If the path is not an absolute path, the file is looked up in the $PATH environment variable. If the file is not present or if it is not executable, the entry may be ignored (not be used in menus, for example). Emitted when #GarconMenuItem has been reloaded. Command to be executed when the application action is clicked. Name of the custom icon associated with this action. Name of the application action (will be displayed in menus etc.). Returns the default #GarconMenuItemCache. the returned object should be unreffed with g_object_unref() when no longer needed. a new #GarconMenuItemCache. a #GarconMenuItemCache parameter passed to @func callback a #GarconMenuItem a #GarconMenuItemCache URI to look for desktop id to update a #GarconMenuItemPool a #GarconMenuItemPool user data passed to @func callback a #GarconMenuItemPool a #GarconMenuItem a #GarconMenuItem object a #GarconMenuItemPool .desktop file a #GarconMenuItem object a #GarconMenuItemPool a GFile instance a #GarconMenuMerger list of files to merge list of menu directories to merge a #GarconMenuNode a #GarconMenuNodeType Recursively copies a #GNode. a #GNode a #GNode if @type is valid menu nodes type. #GNode instance type for the menu nodes list of #GNode a GNode type for the menu nodes list of #GNode a #GNode instance type for the menu nodes a #GarconMenuNode a #GarconMenuNode Returns the default #GarconMenuSeparator. The returned object should be unreffed with g_object_unref() when no longer needed. the default #GarconMenuSeparator. a #GarconMenuTreeProvider a #GNode a #GarconMenuTreeProvider a #GarconMenuTreeProvider a #GNode a #GarconMenuTreeProvider a #GNode a #GarconMenuTreeProvider a #GarconMenuTreeProvider The garcon library provides version information, which could be used by developers to handle new API. Set the desktop environment used by the OnlyShowIn and NotShowIn desktop files keys. Main element the contains the parsed menu. Element that represents a .directory file in the menu configurations. Each menu (except for the root menu) has a #GarconMenuDirectory, see garcon_menu_get_directory(). Interface implemented by the Garcon types #GarconMenuItem, #GarconMenuSeparator and #GarconMenu. Get the environment set with garcon_set_environment(). Name of the desktop environment (e.g. XFCE, KDE, GNOME) which is used or %NULL. Sets (or unsets) the desktop environment for which menus will generated. Menus and menu items belonging to other desktop environments will be ignored. If set to %NULL, all menu items are used. Name of the desktop environment for which menus will be generated (e.g. XFCE, KDE, GNOME or %NULL). Set the desktop environment to the envvar XDG_CURRENT_DESKTOP. If this variables is not set, it falls back to @default_env. For @fallback_env you can use for example #GARCON_ENVIRONMENT_XFCE. fallback value