| 
									
										
										
										
											2011-11-26 22:48:24 -05:00
										 |  |  | /*
 | 
					
						
							|  |  |  |  * Copyright © 2011 Canonical Ltd. | 
					
						
							|  |  |  |  * | 
					
						
							| 
									
										
										
										
											2022-05-18 09:12:45 +01:00
										 |  |  |  * SPDX-License-Identifier: LGPL-2.1-or-later | 
					
						
							|  |  |  |  * | 
					
						
							| 
									
										
										
										
											2017-05-27 18:21:30 +02:00
										 |  |  |  * 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. | 
					
						
							| 
									
										
										
										
											2011-11-26 22:48:24 -05:00
										 |  |  |  * | 
					
						
							|  |  |  |  * 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 | 
					
						
							| 
									
										
										
										
											2014-01-23 12:58:29 +01:00
										 |  |  |  * License along with this library; if not, see <http://www.gnu.org/licenses/>.
 | 
					
						
							| 
									
										
										
										
											2011-11-26 22:48:24 -05:00
										 |  |  |  * | 
					
						
							|  |  |  |  * Author: Ryan Lortie <desrt@desrt.ca> | 
					
						
							|  |  |  |  */ | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #ifndef __G_MENU_H__
 | 
					
						
							|  |  |  | #define __G_MENU_H__
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #include <gio/gmenumodel.h>
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | G_BEGIN_DECLS | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | #define G_TYPE_MENU          (g_menu_get_type ())
 | 
					
						
							|  |  |  | #define G_MENU(inst)         (G_TYPE_CHECK_INSTANCE_CAST ((inst), \
 | 
					
						
							|  |  |  |                               G_TYPE_MENU, GMenu)) | 
					
						
							|  |  |  | #define G_IS_MENU(inst)      (G_TYPE_CHECK_INSTANCE_TYPE ((inst), \
 | 
					
						
							|  |  |  |                               G_TYPE_MENU)) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define G_TYPE_MENU_ITEM     (g_menu_item_get_type ())
 | 
					
						
							|  |  |  | #define G_MENU_ITEM(inst)    (G_TYPE_CHECK_INSTANCE_CAST ((inst), \
 | 
					
						
							|  |  |  |                               G_TYPE_MENU_ITEM, GMenuItem)) | 
					
						
							|  |  |  | #define G_IS_MENU_ITEM(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), \
 | 
					
						
							|  |  |  |                               G_TYPE_MENU_ITEM)) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | typedef struct _GMenuItem GMenuItem; | 
					
						
							|  |  |  | typedef struct _GMenu     GMenu; | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | GType       g_menu_get_type                         (void) G_GNUC_CONST; | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | GMenu *     g_menu_new                              (void); | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | void        g_menu_freeze                           (GMenu       *menu); | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | void        g_menu_insert_item                      (GMenu       *menu, | 
					
						
							|  |  |  |                                                      gint         position, | 
					
						
							|  |  |  |                                                      GMenuItem   *item); | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | void        g_menu_prepend_item                     (GMenu       *menu, | 
					
						
							|  |  |  |                                                      GMenuItem   *item); | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | void        g_menu_append_item                      (GMenu       *menu, | 
					
						
							|  |  |  |                                                      GMenuItem   *item); | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | void        g_menu_remove                           (GMenu       *menu, | 
					
						
							|  |  |  |                                                      gint         position); | 
					
						
							| 
									
										
										
										
											2013-04-08 15:27:16 -04:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_38 | 
					
						
							| 
									
										
										
										
											2013-04-08 15:27:16 -04:00
										 |  |  | void        g_menu_remove_all                       (GMenu       *menu); | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | void        g_menu_insert                           (GMenu       *menu, | 
					
						
							|  |  |  |                                                      gint         position, | 
					
						
							|  |  |  |                                                      const gchar *label, | 
					
						
							|  |  |  |                                                      const gchar *detailed_action); | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | void        g_menu_prepend                          (GMenu       *menu, | 
					
						
							|  |  |  |                                                      const gchar *label, | 
					
						
							|  |  |  |                                                      const gchar *detailed_action); | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | void        g_menu_append                           (GMenu       *menu, | 
					
						
							|  |  |  |                                                      const gchar *label, | 
					
						
							|  |  |  |                                                      const gchar *detailed_action); | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | void        g_menu_insert_section                   (GMenu       *menu, | 
					
						
							|  |  |  |                                                      gint         position, | 
					
						
							|  |  |  |                                                      const gchar *label, | 
					
						
							|  |  |  |                                                      GMenuModel  *section); | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | void        g_menu_prepend_section                  (GMenu       *menu, | 
					
						
							|  |  |  |                                                      const gchar *label, | 
					
						
							|  |  |  |                                                      GMenuModel  *section); | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | void        g_menu_append_section                   (GMenu       *menu, | 
					
						
							|  |  |  |                                                      const gchar *label, | 
					
						
							|  |  |  |                                                      GMenuModel  *section); | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | void        g_menu_insert_submenu                   (GMenu       *menu, | 
					
						
							|  |  |  |                                                      gint        position, | 
					
						
							|  |  |  |                                                      const gchar *label, | 
					
						
							|  |  |  |                                                      GMenuModel  *submenu); | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | void        g_menu_prepend_submenu                  (GMenu       *menu, | 
					
						
							|  |  |  |                                                      const gchar *label, | 
					
						
							|  |  |  |                                                      GMenuModel  *submenu); | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | void        g_menu_append_submenu                   (GMenu       *menu, | 
					
						
							|  |  |  |                                                      const gchar *label, | 
					
						
							|  |  |  |                                                      GMenuModel  *submenu); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | GType       g_menu_item_get_type                    (void) G_GNUC_CONST; | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | GMenuItem * g_menu_item_new                         (const gchar *label, | 
					
						
							|  |  |  |                                                      const gchar *detailed_action); | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_34 | 
					
						
							| 
									
										
										
										
											2012-08-18 14:24:46 -04:00
										 |  |  | GMenuItem * g_menu_item_new_from_model              (GMenuModel  *model, | 
					
						
							|  |  |  |                                                      gint         item_index); | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | GMenuItem * g_menu_item_new_submenu                 (const gchar *label, | 
					
						
							|  |  |  |                                                      GMenuModel  *submenu); | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | GMenuItem * g_menu_item_new_section                 (const gchar *label, | 
					
						
							|  |  |  |                                                      GMenuModel  *section); | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_34 | 
					
						
							| 
									
										
										
										
											2012-08-18 14:20:59 -04:00
										 |  |  | GVariant *  g_menu_item_get_attribute_value         (GMenuItem   *menu_item, | 
					
						
							|  |  |  |                                                      const gchar *attribute, | 
					
						
							| 
									
										
										
										
											2012-09-23 02:18:56 -04:00
										 |  |  |                                                      const GVariantType *expected_type); | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_34 | 
					
						
							| 
									
										
										
										
											2012-08-18 14:20:59 -04:00
										 |  |  | gboolean    g_menu_item_get_attribute               (GMenuItem   *menu_item, | 
					
						
							|  |  |  |                                                      const gchar *attribute, | 
					
						
							|  |  |  |                                                      const gchar *format_string, | 
					
						
							|  |  |  |                                                      ...); | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_34 | 
					
						
							| 
									
										
										
										
											2012-08-18 14:20:59 -04:00
										 |  |  | GMenuModel *g_menu_item_get_link                    (GMenuItem   *menu_item, | 
					
						
							|  |  |  |                                                      const gchar *link); | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | void        g_menu_item_set_attribute_value         (GMenuItem   *menu_item, | 
					
						
							|  |  |  |                                                      const gchar *attribute, | 
					
						
							|  |  |  |                                                      GVariant    *value); | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | void        g_menu_item_set_attribute               (GMenuItem   *menu_item, | 
					
						
							|  |  |  |                                                      const gchar *attribute, | 
					
						
							|  |  |  |                                                      const gchar *format_string, | 
					
						
							|  |  |  |                                                      ...); | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | void        g_menu_item_set_link                    (GMenuItem   *menu_item, | 
					
						
							|  |  |  |                                                      const gchar *link, | 
					
						
							|  |  |  |                                                      GMenuModel  *model); | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | void        g_menu_item_set_label                   (GMenuItem   *menu_item, | 
					
						
							|  |  |  |                                                      const gchar *label); | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | void        g_menu_item_set_submenu                 (GMenuItem   *menu_item, | 
					
						
							|  |  |  |                                                      GMenuModel  *submenu); | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | void        g_menu_item_set_section                 (GMenuItem   *menu_item, | 
					
						
							|  |  |  |                                                      GMenuModel  *section); | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | void        g_menu_item_set_action_and_target_value (GMenuItem   *menu_item, | 
					
						
							|  |  |  |                                                      const gchar *action, | 
					
						
							|  |  |  |                                                      GVariant    *target_value); | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | void        g_menu_item_set_action_and_target       (GMenuItem   *menu_item, | 
					
						
							|  |  |  |                                                      const gchar *action, | 
					
						
							|  |  |  |                                                      const gchar *format_string, | 
					
						
							|  |  |  |                                                      ...); | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_32 | 
					
						
							| 
									
										
										
										
											2011-11-27 01:16:39 -05:00
										 |  |  | void        g_menu_item_set_detailed_action         (GMenuItem   *menu_item, | 
					
						
							|  |  |  |                                                      const gchar *detailed_action); | 
					
						
							| 
									
										
										
										
											2011-11-27 18:46:57 -05:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-10-05 13:39:21 -04:00
										 |  |  | GIO_AVAILABLE_IN_2_38 | 
					
						
							| 
									
										
										
										
											2013-04-20 18:55:03 -04:00
										 |  |  | void        g_menu_item_set_icon                    (GMenuItem   *menu_item, | 
					
						
							|  |  |  |                                                      GIcon       *icon); | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2011-11-26 22:48:24 -05:00
										 |  |  | G_END_DECLS | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #endif /* __G_MENU_H__ */
 |