/usr/include/menu-cache/menu-cache.h

/*
 *      menu-cache.h
 *
 *      libmenu-cache is a small convinient library used to access
 *      caches of freedesktop.org menus generated by menu-cache-gen.
 *
 *      Copyright 2008 PCMan <pcman.tw@gmail.com>
 *      Copyright 2012-2014 Andriy Grytsenko (LStranger) <andrej@rep.kiev.ua>
 *
 *      This library is free software; you can redistribute it and/or
 *      modify it under the terms of the GNU Lesser General Public
 *      License as published by the Free Software Foundation; either
 *      version 2.1 of the License, or (at your option) any later version.
 *
 *      This library is distributed in the hope that it will be useful,
 *      but WITHOUT ANY WARRANTY; without even the implied warranty of
 *      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 *      Lesser General Public License for more details.
 *
 *      You should have received a copy of the GNU Lesser General Public
 *      License along with this library; if not, write to the Free Software
 *      Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 */

#ifndef __MENU_CACHE_H__
#define __MENU_CACHE_H__

#include <glib.h>

G_BEGIN_DECLS

#define __VERSION_MAJOR 1
#define __VERSION_MINOR 0
#define __VERSION_MICRO 2

#define MENU_CACHE_CHECK_VERSION(_a,_b,_c) \
    (__VERSION_MAJOR > _a || \
    (__VERSION_MAJOR == _a && __VERSION_MINOR > _b) || \
    (__VERSION_MAJOR == _a && __VERSION_MINOR == _b && __VERSION_MICRO >= _c))

#define    MENU_CACHE_ITEM(x)    ((MenuCacheItem*)x)
#define    MENU_CACHE_DIR(x)    ((MenuCacheDir*)x)
#define    MENU_CACHE_APP(x)    ((MenuCacheApp*)x)

typedef struct _MenuCacheItem MenuCacheItem;
typedef struct _MenuCacheDir MenuCacheDir;
typedef struct _MenuCacheApp MenuCacheApp;
typedef struct _MenuCache MenuCache;

/**
 * MenuCacheType:
 * @MENU_CACHE_TYPE_NONE: invalid type
 * @MENU_CACHE_TYPE_DIR: item #MenuCacheDir
 * @MENU_CACHE_TYPE_APP: item #MenuCacheApp
 * @MENU_CACHE_TYPE_SEP: menu separator
 *
 * type of #MenuCacheItem.
 */
typedef enum
{
    MENU_CACHE_TYPE_NONE,
    MENU_CACHE_TYPE_DIR,
    MENU_CACHE_TYPE_APP,
    MENU_CACHE_TYPE_SEP
}MenuCacheType;

/**
 * MenuCacheShowFlag:
 * @SHOW_IN_LXDE: show in LXDE
 * @SHOW_IN_GNOME: show in GNOME
 * @SHOW_IN_KDE: show in KDE
 * @SHOW_IN_XFCE: show in XFCE
 * @SHOW_IN_ROX: show in ROX
 *
 * bitmask of desktop environments where the item should be visible.
 */
typedef enum
{
    SHOW_IN_LXDE = 1 << 0,
    SHOW_IN_GNOME = 1 << 1,
    SHOW_IN_KDE = 1 << 2,
    SHOW_IN_XFCE = 1 << 3,
    SHOW_IN_ROX = 1 << 4,
    /*< private >*/
    N_KNOWN_DESKTOPS = 5
}MenuCacheShowFlag;

/**
 * MenuCacheItemFlag:
 * @FLAG_USE_TERMINAL: run this application in terminal
 * @FLAG_USE_SN: use Startup Notify for this application
 * @FLAG_IS_NODISPLAY: application is hidden from menu
 *
 * flags for application run.
 */
typedef enum
{
    FLAG_USE_TERMINAL = 1 << 0,
    FLAG_USE_SN = 1 << 1,
    FLAG_IS_NODISPLAY = 1 << 2
}MenuCacheItemFlag;

void menu_cache_init(int flags);

MenuCache* menu_cache_lookup( const char* menu_name );
MenuCache* menu_cache_lookup_sync( const char* menu_name );

MenuCache* menu_cache_ref(MenuCache* cache);
void menu_cache_unref(MenuCache* cache);

gboolean menu_cache_reload( MenuCache* cache );

#ifndef G_DISABLE_DEPRECATED
MenuCacheDir* menu_cache_get_root_dir( MenuCache* cache );
MenuCacheDir* menu_cache_get_dir_from_path( MenuCache* cache, const char* path );
#endif
MenuCacheDir* menu_cache_dup_root_dir( MenuCache* cache );
MenuCacheItem* menu_cache_item_from_path( MenuCache* cache, const char* path );

typedef struct _MenuCacheNotifyId* MenuCacheNotifyId;
typedef void (*MenuCacheReloadNotify)(MenuCache* cache, gpointer user_data);

MenuCacheNotifyId menu_cache_add_reload_notify(MenuCache* cache,
                                               MenuCacheReloadNotify func,
                                               gpointer user_data);
void menu_cache_remove_reload_notify(MenuCache* cache, MenuCacheNotifyId notify_id);

guint32 menu_cache_get_desktop_env_flag( MenuCache* cache, const char* desktop_env );

MenuCacheItem* menu_cache_item_ref(MenuCacheItem* item);
gboolean menu_cache_item_unref(MenuCacheItem* item);

MenuCacheType menu_cache_item_get_type( MenuCacheItem* item );
const char* menu_cache_item_get_id( MenuCacheItem* item );
const char* menu_cache_item_get_name( MenuCacheItem* item );
const char* menu_cache_item_get_comment( MenuCacheItem* item );
const char* menu_cache_item_get_icon( MenuCacheItem* item );

const char* menu_cache_item_get_file_basename( MenuCacheItem* item );
const char* menu_cache_item_get_file_dirname( MenuCacheItem* item );
char* menu_cache_item_get_file_path( MenuCacheItem* item );

#ifndef G_DISABLE_DEPRECATED
MenuCacheDir* menu_cache_item_get_parent( MenuCacheItem* item );
GSList* menu_cache_dir_get_children( MenuCacheDir* dir );
#endif
MenuCacheDir* menu_cache_item_dup_parent( MenuCacheItem* item );
GSList* menu_cache_dir_list_children( MenuCacheDir* dir );
MenuCacheItem *menu_cache_find_child_by_id(MenuCacheDir *dir, const char *id);
MenuCacheItem *menu_cache_find_child_by_name(MenuCacheDir *dir, const char *name);

char* menu_cache_dir_make_path( MenuCacheDir* dir );

const char* menu_cache_app_get_exec( MenuCacheApp* app );
const char* menu_cache_app_get_working_dir( MenuCacheApp* app );
const char* const *menu_cache_app_get_categories(MenuCacheApp* app);

guint32 menu_cache_app_get_show_flags( MenuCacheApp* app );
gboolean menu_cache_app_get_is_visible( MenuCacheApp* app, guint32 de_flags );
gboolean menu_cache_dir_is_visible(MenuCacheDir *dir);

gboolean menu_cache_app_get_use_terminal( MenuCacheApp* app );
gboolean menu_cache_app_get_use_sn( MenuCacheApp* app );

GSList* menu_cache_list_all_apps(MenuCache* cache);
GSList *menu_cache_list_all_for_category(MenuCache* cache, const char *category);
GSList *menu_cache_list_all_for_keyword(MenuCache* cache, const char *keyword);

MenuCacheItem *menu_cache_find_item_by_id(MenuCache *cache, const char *id);
/*
MenuCacheApp* menu_cache_find_app_by_exec( const char* exec );
*/
G_END_DECLS

#endif
libmenu-cache-dev 1.0.2-3 / usr / include / menu-cache / menu-cache.h
