1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162 | /*
* Copyright (C) 2004 Red Hat, Inc.
*
* 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 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 St, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef __CAFEMENU_TREE_H__
#define __CAFEMENU_TREE_H__
#ifndef CAFEMENU_I_KNOW_THIS_IS_UNSTABLE
#error "libcafe-menu should only be used if you understand that it's subject to frequent change, and is not supported as a fixed API/ABI or as part of the platform"<--- #error "libcafe-menu should only be used if you understand that it's subject to frequent change, and is not supported as a fixed API/ABI or as part of the platform"
#endif
#include <gio/gdesktopappinfo.h>
G_BEGIN_DECLS
#define CAFEMENU_TYPE_TREE (cafemenu_tree_get_type ())
#define CAFEMENU_TREE(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), CAFEMENU_TYPE_TREE, CafeMenuTree))
#define CAFEMENU_TREE_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), CAFEMENU_TYPE_TREE, CafeMenuTreeClass))
#define CAFEMENU_IS_TREE(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), CAFEMENU_TYPE_TREE))
#define CAFEMENU_IS_TREE_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), CAFEMENU_TYPE_TREE))
#define CAFEMENU_TREE_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_DESKTOP_APP_INFO, CafeMenuTreeClass))
typedef struct _CafeMenuTree CafeMenuTree;
typedef struct _CafeMenuTreeClass CafeMenuTreeClass;
struct _CafeMenuTreeClass
{
GObjectClass parent_class;
};
GType cafemenu_tree_get_type (void) G_GNUC_CONST;
typedef struct CafeMenuTreeIter CafeMenuTreeIter;
typedef struct CafeMenuTreeDirectory CafeMenuTreeDirectory;
typedef struct CafeMenuTreeEntry CafeMenuTreeEntry;
typedef struct CafeMenuTreeSeparator CafeMenuTreeSeparator;
typedef struct CafeMenuTreeHeader CafeMenuTreeHeader;
typedef struct CafeMenuTreeAlias CafeMenuTreeAlias;
typedef enum
{
CAFEMENU_TREE_ITEM_INVALID = 0,
CAFEMENU_TREE_ITEM_DIRECTORY,
CAFEMENU_TREE_ITEM_ENTRY,
CAFEMENU_TREE_ITEM_SEPARATOR,
CAFEMENU_TREE_ITEM_HEADER,
CAFEMENU_TREE_ITEM_ALIAS
} CafeMenuTreeItemType;
GType cafemenu_tree_iter_get_type (void);
/* Explicitly skip item, it's a "hidden" base class */
GType cafemenu_tree_directory_get_type (void);
GType cafemenu_tree_entry_get_type (void);
GType cafemenu_tree_separator_get_type (void);
GType cafemenu_tree_header_get_type (void);
GType cafemenu_tree_alias_get_type (void);
typedef enum
{
CAFEMENU_TREE_FLAGS_NONE = 0,
CAFEMENU_TREE_FLAGS_INCLUDE_EXCLUDED = 1 << 0,
CAFEMENU_TREE_FLAGS_INCLUDE_NODISPLAY = 1 << 1,
CAFEMENU_TREE_FLAGS_INCLUDE_UNALLOCATED = 1 << 2,
/* leave some space for more include flags */
CAFEMENU_TREE_FLAGS_SHOW_EMPTY = 1 << 8,
CAFEMENU_TREE_FLAGS_SHOW_ALL_SEPARATORS = 1 << 9,
/* leave some space for more show flags */
CAFEMENU_TREE_FLAGS_SORT_DISPLAY_NAME = 1 << 16
} CafeMenuTreeFlags;
GType cafemenu_tree_flags_get_type (void);
#define CAFEMENU_TYPE_TREE_FLAGS (cafemenu_tree_flags_get_type ())
CafeMenuTree *cafemenu_tree_new (const char *menu_basename,
CafeMenuTreeFlags flags);
CafeMenuTree *cafemenu_tree_new_for_path (const char *menu_path,
CafeMenuTreeFlags flags);
gboolean cafemenu_tree_load_sync (CafeMenuTree *tree,
GError **error);
const char *cafemenu_tree_get_canonical_menu_path (CafeMenuTree *tree);
CafeMenuTreeDirectory *cafemenu_tree_get_root_directory (CafeMenuTree *tree);
CafeMenuTreeDirectory *cafemenu_tree_get_directory_from_path (CafeMenuTree *tree,
const char *path);
CafeMenuTreeEntry *cafemenu_tree_get_entry_by_id (CafeMenuTree *tree,
const char *id);
gpointer cafemenu_tree_item_ref (gpointer item);
void cafemenu_tree_item_unref (gpointer item);
CafeMenuTreeDirectory *cafemenu_tree_directory_get_parent (CafeMenuTreeDirectory *directory);
const char *cafemenu_tree_directory_get_name (CafeMenuTreeDirectory *directory);
const char *cafemenu_tree_directory_get_generic_name (CafeMenuTreeDirectory *directory);
const char *cafemenu_tree_directory_get_comment (CafeMenuTreeDirectory *directory);
GIcon *cafemenu_tree_directory_get_icon (CafeMenuTreeDirectory *directory);
const char *cafemenu_tree_directory_get_desktop_file_path (CafeMenuTreeDirectory *directory);
const char *cafemenu_tree_directory_get_menu_id (CafeMenuTreeDirectory *directory);
CafeMenuTree *cafemenu_tree_directory_get_tree (CafeMenuTreeDirectory *directory);
gboolean cafemenu_tree_directory_get_is_nodisplay (CafeMenuTreeDirectory *directory);
CafeMenuTreeIter *cafemenu_tree_directory_iter (CafeMenuTreeDirectory *directory);
CafeMenuTreeIter *cafemenu_tree_iter_ref (CafeMenuTreeIter *iter);
void cafemenu_tree_iter_unref (CafeMenuTreeIter *iter);
CafeMenuTreeItemType cafemenu_tree_iter_next (CafeMenuTreeIter *iter);
CafeMenuTreeDirectory *cafemenu_tree_iter_get_directory (CafeMenuTreeIter *iter);
CafeMenuTreeEntry *cafemenu_tree_iter_get_entry (CafeMenuTreeIter *iter);
CafeMenuTreeHeader *cafemenu_tree_iter_get_header (CafeMenuTreeIter *iter);
CafeMenuTreeAlias *cafemenu_tree_iter_get_alias (CafeMenuTreeIter *iter);
CafeMenuTreeSeparator *cafemenu_tree_iter_get_separator (CafeMenuTreeIter *iter);
char *cafemenu_tree_directory_make_path (CafeMenuTreeDirectory *directory,
CafeMenuTreeEntry *entry);
GDesktopAppInfo *cafemenu_tree_entry_get_app_info (CafeMenuTreeEntry *entry);
CafeMenuTreeDirectory *cafemenu_tree_entry_get_parent (CafeMenuTreeEntry *entry);
CafeMenuTree *cafemenu_tree_entry_get_tree (CafeMenuTreeEntry *entry);
const char *cafemenu_tree_entry_get_desktop_file_path (CafeMenuTreeEntry *entry);
const char *cafemenu_tree_entry_get_desktop_file_id (CafeMenuTreeEntry *entry);
gboolean cafemenu_tree_entry_get_is_nodisplay_recurse (CafeMenuTreeEntry *entry);
gboolean cafemenu_tree_entry_get_is_excluded (CafeMenuTreeEntry *entry);
gboolean cafemenu_tree_entry_get_is_unallocated (CafeMenuTreeEntry *entry);
CafeMenuTreeDirectory *cafemenu_tree_header_get_directory (CafeMenuTreeHeader *header);
CafeMenuTree *cafemenu_tree_header_get_tree (CafeMenuTreeHeader *header);
CafeMenuTreeDirectory *cafemenu_tree_header_get_parent (CafeMenuTreeHeader *header);
CafeMenuTreeDirectory *cafemenu_tree_alias_get_directory (CafeMenuTreeAlias *alias);
CafeMenuTreeItemType cafemenu_tree_alias_get_aliased_item_type (CafeMenuTreeAlias *alias);
CafeMenuTreeDirectory *cafemenu_tree_alias_get_aliased_directory (CafeMenuTreeAlias *alias);
CafeMenuTreeEntry *cafemenu_tree_alias_get_aliased_entry (CafeMenuTreeAlias *alias);
CafeMenuTree *cafemenu_tree_alias_get_tree (CafeMenuTreeAlias *alias);
CafeMenuTreeDirectory *cafemenu_tree_alias_get_parent (CafeMenuTreeAlias *alias);
CafeMenuTree *cafemenu_tree_separator_get_tree (CafeMenuTreeSeparator *separator);
CafeMenuTreeDirectory *cafemenu_tree_separator_get_parent (CafeMenuTreeSeparator *separator);
G_END_DECLS
#endif /* __CAFEMENU_TREE_H__ */
|