nautilus/libnautilus-extension/nautilus-menu.h
Martin Wehner 0a9fe18765 Add extension versioning infrastructure and add nautilus-menu.[ch].
2006-07-24  Martin Wehner  <martin.wehner@gmail.com>

	* configure.in:
	* libnautilus-extension/Makefile.am:
	Add extension versioning infrastructure and add nautilus-menu.[ch].

	* libnautilus-extension/nautilus-menu-item.[ch]:
	Add and handle a 'menu' property and add a function
	nautilus_menu_item_set_submenu.

	* libnautilus-extension/nautilus-menu.[ch]:
	New files implementing a submenu item.

	* src/file-manager/fm-directory-view.c: (add_extension_menu_items),
	(reset_extension_actions_menu):
	Add extension menu items recursively.

	* libnautilus-extension/nautilus-menu-provider.h:
	Update include.

	Extend extension API to support submenus. (#314579)

	Patch from Raffaele Sandrini  <rasa@gmx.ch>
2006-07-24 21:38:26 +00:00

118 lines
4.4 KiB
C

/*
* nautilus-menu.h - Menus exported by NautilusMenuProvider objects.
*
* Copyright (C) 2005 Raffaele Sandrini
* Copyright (C) 2003 Novell, Inc.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library 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
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the Free
* Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*
* Author: Dave Camp <dave@ximian.com>
* Raffaele Sandrini <rasa@gmx.ch>
*
*/
#ifndef NAUTILUS_MENU_H
#define NAUTILUS_MENU_H
#include <glib-object.h>
#include "nautilus-extension-types.h"
G_BEGIN_DECLS
/* NautilusMenu defines */
#define NAUTILUS_TYPE_MENU (nautilus_menu_get_type ())
#define NAUTILUS_MENU(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), NAUTILUS_TYPE_MENU, NautilusMenu))
#define NAUTILUS_MENU_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), NAUTILUS_TYPE_MENU, NautilusMenuClass))
#define NAUTILUS_IS_MENU(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), NAUTILUS_TYPE_MENU))
#define NAUTILUS_IS_MENU_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), NAUTILUS_TYPE_MENU))
#define NAUTILUS_MENU_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), NAUTILUS_TYPE_MENU, NautilusMenuClass))
/* NautilusMenuItem defines */
#define NAUTILUS_TYPE_MENU_ITEM (nautilus_menu_item_get_type())
#define NAUTILUS_MENU_ITEM(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), NAUTILUS_TYPE_MENU_ITEM, NautilusMenuItem))
#define NAUTILUS_MENU_ITEM_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), NAUTILUS_TYPE_MENU_ITEM, NautilusMenuItemClass))
#define NAUTILUS_MENU_IS_ITEM(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), NAUTILUS_TYPE_MENU_ITEM))
#define NAUTILUS_MENU_IS_ITEM_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((obj), NAUTILUS_TYPE_MENU_ITEM))
#define NAUTILUS_MENU_ITEM_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS((obj), NAUTILUS_TYPE_MENU_ITEM, NautilusMenuItemClass))
/* NautilusMenu types */
typedef struct _NautilusMenu NautilusMenu;
typedef struct _NautilusMenuPrivate NautilusMenuPrivate;
typedef struct _NautilusMenuClass NautilusMenuClass;
/* NautilusMenuItem types */
typedef struct _NautilusMenuItem NautilusMenuItem;
typedef struct _NautilusMenuItemDetails NautilusMenuItemDetails;
typedef struct _NautilusMenuItemClass NautilusMenuItemClass;
/* NautilusMenu structs */
struct _NautilusMenu {
GObject parent;
NautilusMenuPrivate *private;
};
struct _NautilusMenuClass {
GObjectClass parent_class;
};
/* NautilusMenuItem structs */
struct _NautilusMenuItem {
GObject parent;
NautilusMenuItemDetails *details;
};
struct _NautilusMenuItemClass {
GObjectClass parent;
void (*activate) (NautilusMenuItem *item);
};
/* NautilusMenu methods */
GType nautilus_menu_get_type (void);
NautilusMenu * nautilus_menu_new (void);
void nautilus_menu_append_item (NautilusMenu *this,
NautilusMenuItem *item);
GList* nautilus_menu_get_items (NautilusMenu *this);
void nautilus_menu_item_list_free (GList *item_list);
/* NautilusMenuItem methods */
GType nautilus_menu_item_get_type (void);
NautilusMenuItem *nautilus_menu_item_new (const char *name,
const char *label,
const char *tip,
const char *icon);
void nautilus_menu_item_activate (NautilusMenuItem *item);
void nautilus_menu_item_set_submenu (NautilusMenuItem *item,
NautilusMenu *menu);
/* NautilusMenuItem has the following properties:
* name (string) - the identifier for the menu item
* label (string) - the user-visible label of the menu item
* tip (string) - the tooltip of the menu item
* icon (string) - the name of the icon to display in the menu item
* sensitive (boolean) - whether the menu item is sensitive or not
* priority (boolean) - used for toolbar items, whether to show priority
* text.
* menu (NautilusMenu) - The menu belonging to this item. May be null.
*/
G_END_DECLS
#endif /* NAUTILUS_MENU_H */