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
|
/*
* nautilus-menu-provider.h - Interface for Nautilus extensions that
* provide context menu items.
*
* 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, see <http://www.gnu.org/licenses/>.
*
* Author: Dave Camp <dave@ximian.com>
*
*/
/* This interface is implemented by Nautilus extensions that want to
* add context menu entries to files. Extensions are called when
* Nautilus constructs the context menu for a file. They are passed a
* list of NautilusFileInfo objects which holds the current selection */
#pragma once
#if !defined (NAUTILUS_EXTENSION_H) && !defined (NAUTILUS_COMPILATION)
#warning "Only <nautilus-extension.h> should be included directly."
#endif
#include <glib-object.h>
#include <gtk/gtk.h>
#include "nautilus-file-info.h"
/* These should be removed at some point. */
#include "nautilus-extension-types.h"
#include "nautilus-menu.h"
G_BEGIN_DECLS
#define NAUTILUS_TYPE_MENU_PROVIDER (nautilus_menu_provider_get_type ())
G_DECLARE_INTERFACE (NautilusMenuProvider, nautilus_menu_provider,
NAUTILUS, MENU_PROVIDER,
GObject)
/* For compatibility reasons, remove this once you start introducing breaking changes. */
typedef NautilusMenuProviderInterface NautilusMenuProviderIface;
/**
* SECTION:nautilus-menu-provider
* @title: NautilusMenuProvider
* @short_description: Interface to provide additional menu items
*
* #NautilusMenuProvider allows extension to provide additional menu items
* in the file manager menus.
*/
/**
* NautilusMenuProviderInterface:
* @g_iface: The parent interface.
* @get_file_items: Returns a #GList of #NautilusMenuItem.
* See nautilus_menu_provider_get_file_items() for details.
* @get_background_items: Returns a #GList of #NautilusMenuItem.
* See nautilus_menu_provider_get_background_items() for details.
*
* Interface for extensions to provide additional menu items.
*/
struct _NautilusMenuProviderInterface
{
GTypeInterface g_iface;
GList *(*get_file_items) (NautilusMenuProvider *provider,
GtkWidget *window,
GList *files);
GList *(*get_background_items) (NautilusMenuProvider *provider,
GtkWidget *window,
NautilusFileInfo *current_folder);
};
/**
* nautilus_menu_provider_get_file_items:
* @provider: a #NautilusMenuProvider
* @window: the parent #GtkWidget window
* @files: (element-type NautilusFileInfo): a list of #NautilusFileInfo
*
* Returns: (nullable) (element-type NautilusMenuItem) (transfer full): the provided list of #NautilusMenuItem.
*/
GList *nautilus_menu_provider_get_file_items (NautilusMenuProvider *provider,
GtkWidget *window,
GList *files);
/**
* nautilus_menu_provider_get_background_items:
* @provider: a #NautilusMenuProvider
* @window: the parent #GtkWidget window
* @current_folder: the folder for which background items are requested
*
* Returns: (nullable) (element-type NautilusMenuItem) (transfer full): the provided list of #NautilusMenuItem.
*/
GList *nautilus_menu_provider_get_background_items (NautilusMenuProvider *provider,
GtkWidget *window,
NautilusFileInfo *current_folder);
/**
* nautilus_menu_provider_emit_items_updated_signal:
* @provider: a #NautilusMenuProvider
*
* Emits #NautilusMenuProvider::items-updated.
*/
void nautilus_menu_provider_emit_items_updated_signal (NautilusMenuProvider *provider);
G_END_DECLS
|
