1/*
2 * Copyright © 2011 Canonical Ltd.
3 *
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2.1 of the License, or (at your option) any later version.
8 *
9 * This library is distributed in the hope that it will be useful, but
10 * WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
13 *
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, see <http://www.gnu.org/licenses/>.
16 *
17 * Author: Ryan Lortie <desrt@desrt.ca>
18 */
19
20#ifndef __G_MENU_MODEL_H__
21#define __G_MENU_MODEL_H__
22
23#include <glib-object.h>
24
25#include <gio/giotypes.h>
26
27G_BEGIN_DECLS
28
29/**
30 * G_MENU_ATTRIBUTE_ACTION:
31 *
32 * The menu item attribute which holds the action name of the item. Action
33 * names are namespaced with an identifier for the action group in which the
34 * action resides. For example, "win." for window-specific actions and "app."
35 * for application-wide actions.
36 *
37 * See also g_menu_model_get_item_attribute() and g_menu_item_set_attribute().
38 *
39 * Since: 2.32
40 **/
41#define G_MENU_ATTRIBUTE_ACTION "action"
42
43/**
44 * G_MENU_ATTRIBUTE_ACTION_NAMESPACE:
45 *
46 * The menu item attribute that holds the namespace for all action names in
47 * menus that are linked from this item.
48 *
49 * Since: 2.36
50 **/
51#define G_MENU_ATTRIBUTE_ACTION_NAMESPACE "action-namespace"
52
53/**
54 * G_MENU_ATTRIBUTE_TARGET:
55 *
56 * The menu item attribute which holds the target with which the item's action
57 * will be activated.
58 *
59 * See also g_menu_item_set_action_and_target()
60 *
61 * Since: 2.32
62 **/
63#define G_MENU_ATTRIBUTE_TARGET "target"
64
65/**
66 * G_MENU_ATTRIBUTE_LABEL:
67 *
68 * The menu item attribute which holds the label of the item.
69 *
70 * Since: 2.32
71 **/
72#define G_MENU_ATTRIBUTE_LABEL "label"
73
74/**
75 * G_MENU_ATTRIBUTE_ICON:
76 *
77 * The menu item attribute which holds the icon of the item.
78 *
79 * The icon is stored in the format returned by g_icon_serialize().
80 *
81 * This attribute is intended only to represent 'noun' icons such as
82 * favicons for a webpage, or application icons. It should not be used
83 * for 'verbs' (ie: stock icons).
84 *
85 * Since: 2.38
86 **/
87#define G_MENU_ATTRIBUTE_ICON "icon"
88
89/**
90 * G_MENU_LINK_SUBMENU:
91 *
92 * The name of the link that associates a menu item with a submenu.
93 *
94 * See also g_menu_item_set_link().
95 *
96 * Since: 2.32
97 **/
98#define G_MENU_LINK_SUBMENU "submenu"
99
100/**
101 * G_MENU_LINK_SECTION:
102 *
103 * The name of the link that associates a menu item with a section. The linked
104 * menu will usually be shown in place of the menu item, using the item's label
105 * as a header.
106 *
107 * See also g_menu_item_set_link().
108 *
109 * Since: 2.32
110 **/
111#define G_MENU_LINK_SECTION "section"
112
113#define G_TYPE_MENU_MODEL (g_menu_model_get_type ())
114#define G_MENU_MODEL(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), \
115 G_TYPE_MENU_MODEL, GMenuModel))
116#define G_MENU_MODEL_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), \
117 G_TYPE_MENU_MODEL, GMenuModelClass))
118#define G_IS_MENU_MODEL(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), \
119 G_TYPE_MENU_MODEL))
120#define G_IS_MENU_MODEL_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), \
121 G_TYPE_MENU_MODEL))
122#define G_MENU_MODEL_GET_CLASS(inst) (G_TYPE_INSTANCE_GET_CLASS ((inst), \
123 G_TYPE_MENU_MODEL, GMenuModelClass))
124
125typedef struct _GMenuModelPrivate GMenuModelPrivate;
126typedef struct _GMenuModelClass GMenuModelClass;
127
128typedef struct _GMenuAttributeIterPrivate GMenuAttributeIterPrivate;
129typedef struct _GMenuAttributeIterClass GMenuAttributeIterClass;
130typedef struct _GMenuAttributeIter GMenuAttributeIter;
131
132typedef struct _GMenuLinkIterPrivate GMenuLinkIterPrivate;
133typedef struct _GMenuLinkIterClass GMenuLinkIterClass;
134typedef struct _GMenuLinkIter GMenuLinkIter;
135
136struct _GMenuModel
137{
138 GObject parent_instance;
139 GMenuModelPrivate *priv;
140};
141
142/**
143 * GMenuModelClass::get_item_attributes:
144 * @model: the #GMenuModel to query
145 * @item_index: The #GMenuItem to query
146 * @attributes: (out) (element-type utf8 GLib.Variant): Attributes on the item
147 *
148 * Gets all the attributes associated with the item in the menu model.
149 */
150/**
151 * GMenuModelClass::get_item_links:
152 * @model: the #GMenuModel to query
153 * @item_index: The #GMenuItem to query
154 * @links: (out) (element-type utf8 Gio.MenuModel): Links from the item
155 *
156 * Gets all the links associated with the item in the menu model.
157 */
158struct _GMenuModelClass
159{
160 GObjectClass parent_class;
161
162 gboolean (*is_mutable) (GMenuModel *model);
163 gint (*get_n_items) (GMenuModel *model);
164 void (*get_item_attributes) (GMenuModel *model,
165 gint item_index,
166 GHashTable **attributes);
167 GMenuAttributeIter * (*iterate_item_attributes) (GMenuModel *model,
168 gint item_index);
169 GVariant * (*get_item_attribute_value) (GMenuModel *model,
170 gint item_index,
171 const gchar *attribute,
172 const GVariantType *expected_type);
173 void (*get_item_links) (GMenuModel *model,
174 gint item_index,
175 GHashTable **links);
176 GMenuLinkIter * (*iterate_item_links) (GMenuModel *model,
177 gint item_index);
178 GMenuModel * (*get_item_link) (GMenuModel *model,
179 gint item_index,
180 const gchar *link);
181};
182
183GLIB_AVAILABLE_IN_2_32
184GType g_menu_model_get_type (void) G_GNUC_CONST;
185
186GLIB_AVAILABLE_IN_2_32
187gboolean g_menu_model_is_mutable (GMenuModel *model);
188GLIB_AVAILABLE_IN_2_32
189gint g_menu_model_get_n_items (GMenuModel *model);
190
191GLIB_AVAILABLE_IN_2_32
192GMenuAttributeIter * g_menu_model_iterate_item_attributes (GMenuModel *model,
193 gint item_index);
194GLIB_AVAILABLE_IN_2_32
195GVariant * g_menu_model_get_item_attribute_value (GMenuModel *model,
196 gint item_index,
197 const gchar *attribute,
198 const GVariantType *expected_type);
199GLIB_AVAILABLE_IN_2_32
200gboolean g_menu_model_get_item_attribute (GMenuModel *model,
201 gint item_index,
202 const gchar *attribute,
203 const gchar *format_string,
204 ...);
205GLIB_AVAILABLE_IN_2_32
206GMenuLinkIter * g_menu_model_iterate_item_links (GMenuModel *model,
207 gint item_index);
208GLIB_AVAILABLE_IN_2_32
209GMenuModel * g_menu_model_get_item_link (GMenuModel *model,
210 gint item_index,
211 const gchar *link);
212
213GLIB_AVAILABLE_IN_2_32
214void g_menu_model_items_changed (GMenuModel *model,
215 gint position,
216 gint removed,
217 gint added);
218
219
220#define G_TYPE_MENU_ATTRIBUTE_ITER (g_menu_attribute_iter_get_type ())
221#define G_MENU_ATTRIBUTE_ITER(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), \
222 G_TYPE_MENU_ATTRIBUTE_ITER, GMenuAttributeIter))
223#define G_MENU_ATTRIBUTE_ITER_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), \
224 G_TYPE_MENU_ATTRIBUTE_ITER, GMenuAttributeIterClass))
225#define G_IS_MENU_ATTRIBUTE_ITER(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), \
226 G_TYPE_MENU_ATTRIBUTE_ITER))
227#define G_IS_MENU_ATTRIBUTE_ITER_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), \
228 G_TYPE_MENU_ATTRIBUTE_ITER))
229#define G_MENU_ATTRIBUTE_ITER_GET_CLASS(inst) (G_TYPE_INSTANCE_GET_CLASS ((inst), \
230 G_TYPE_MENU_ATTRIBUTE_ITER, GMenuAttributeIterClass))
231
232struct _GMenuAttributeIter
233{
234 GObject parent_instance;
235 GMenuAttributeIterPrivate *priv;
236};
237
238struct _GMenuAttributeIterClass
239{
240 GObjectClass parent_class;
241
242 gboolean (*get_next) (GMenuAttributeIter *iter,
243 const gchar **out_name,
244 GVariant **value);
245};
246
247GLIB_AVAILABLE_IN_2_32
248GType g_menu_attribute_iter_get_type (void) G_GNUC_CONST;
249
250GLIB_AVAILABLE_IN_2_32
251gboolean g_menu_attribute_iter_get_next (GMenuAttributeIter *iter,
252 const gchar **out_name,
253 GVariant **value);
254GLIB_AVAILABLE_IN_2_32
255gboolean g_menu_attribute_iter_next (GMenuAttributeIter *iter);
256GLIB_AVAILABLE_IN_2_32
257const gchar * g_menu_attribute_iter_get_name (GMenuAttributeIter *iter);
258GLIB_AVAILABLE_IN_2_32
259GVariant * g_menu_attribute_iter_get_value (GMenuAttributeIter *iter);
260
261
262#define G_TYPE_MENU_LINK_ITER (g_menu_link_iter_get_type ())
263#define G_MENU_LINK_ITER(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), \
264 G_TYPE_MENU_LINK_ITER, GMenuLinkIter))
265#define G_MENU_LINK_ITER_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), \
266 G_TYPE_MENU_LINK_ITER, GMenuLinkIterClass))
267#define G_IS_MENU_LINK_ITER(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), \
268 G_TYPE_MENU_LINK_ITER))
269#define G_IS_MENU_LINK_ITER_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), \
270 G_TYPE_MENU_LINK_ITER))
271#define G_MENU_LINK_ITER_GET_CLASS(inst) (G_TYPE_INSTANCE_GET_CLASS ((inst), \
272 G_TYPE_MENU_LINK_ITER, GMenuLinkIterClass))
273
274struct _GMenuLinkIter
275{
276 GObject parent_instance;
277 GMenuLinkIterPrivate *priv;
278};
279
280struct _GMenuLinkIterClass
281{
282 GObjectClass parent_class;
283
284 gboolean (*get_next) (GMenuLinkIter *iter,
285 const gchar **out_link,
286 GMenuModel **value);
287};
288
289GLIB_AVAILABLE_IN_2_32
290GType g_menu_link_iter_get_type (void) G_GNUC_CONST;
291
292GLIB_AVAILABLE_IN_2_32
293gboolean g_menu_link_iter_get_next (GMenuLinkIter *iter,
294 const gchar **out_link,
295 GMenuModel **value);
296GLIB_AVAILABLE_IN_2_32
297gboolean g_menu_link_iter_next (GMenuLinkIter *iter);
298GLIB_AVAILABLE_IN_2_32
299const gchar * g_menu_link_iter_get_name (GMenuLinkIter *iter);
300GLIB_AVAILABLE_IN_2_32
301GMenuModel * g_menu_link_iter_get_value (GMenuLinkIter *iter);
302
303G_END_DECLS
304
305#endif /* __G_MENU_MODEL_H__ */
306