summaryrefslogtreecommitdiff
path: root/libnautilus-extension/nautilus-property-page-provider.h
blob: 61bcd8b6355fd00b19211cf3c4cb041fb6544f2b (plain)
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
/*
 *  nautilus-property-page-provider.h - Interface for Nautilus extensions
 *                                      that provide property pages.
 *
 *  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 property page to property dialogs.  Extensions are called when 
 * Nautilus needs property pages for a selection.  They are passed a 
 * list of NautilusFileInfo objects for which information should
 * be displayed  */

#pragma once

#if !defined (NAUTILUS_EXTENSION_H) && !defined (NAUTILUS_COMPILATION)
#warning "Only <nautilus-extension.h> should be included directly."
#endif

#include <glib-object.h>
/* These should be removed at some point. */
#include "nautilus-extension-types.h"
#include "nautilus-file-info.h"
#include "nautilus-property-page.h"


G_BEGIN_DECLS

#define NAUTILUS_TYPE_PROPERTY_PAGE_PROVIDER (nautilus_property_page_provider_get_type ())

G_DECLARE_INTERFACE (NautilusPropertyPageProvider, nautilus_property_page_provider,
                     NAUTILUS, PROPERTY_PAGE_PROVIDER,
                     GObject)

/* For compatibility reasons, remove this once you start introducing breaking changes. */
typedef NautilusPropertyPageProviderInterface NautilusPropertyPageProviderIface;

/**
 * SECTION:nautilus-property-page-provider
 * @title: NautilusPropertyPageProvider
 * @short_description: Interface to provide additional property pages
 *
 * #NautilusPropertyPageProvider allows extension to provide additional pages
 * for the file properties dialog.
 */

/**
 * NautilusPropertyPageProviderInterface:
 * @g_iface: The parent interface.
 * @get_pages: Returns a #GList of #NautilusPropertyPage.
 *   See nautilus_property_page_provider_get_pages() for details.
 *
 * Interface for extensions to provide additional property pages.
 */
struct _NautilusPropertyPageProviderInterface
{
    GTypeInterface g_iface;

    GList *(*get_pages) (NautilusPropertyPageProvider *provider,
                         GList                        *files);
};

/**
 * nautilus_property_page_provider_get_pages:
 * @provider: a #NautilusPropertyPageProvider
 * @files: (element-type NautilusFileInfo): a #GList of #NautilusFileInfo
 *
 * This function is called by Nautilus when it wants property page
 * items from the extension.
 *
 * This function is called in the main thread before a property page
 * is shown, so it should return quickly.
 *
 * Returns: (element-type NautilusPropertyPage) (transfer full): A #GList of allocated #NautilusPropertyPage items.
 */
GList *nautilus_property_page_provider_get_pages (NautilusPropertyPageProvider *provider,
                                                  GList                        *files);

G_END_DECLS