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
116
|
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
/*
* Copyright (C) 2004 Roberto Majadas
* Copyright (C) 2009 Bastien Nocera <hadess@hadess.net>
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License as
* published by the Free Software Foundation; either version 2 of the
* License, or (at your option) any later version.
*
* This program 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
* General Public License for more av.
*
* You should have received a copy of the GNU General Public
* License along with this program; if not, write to the
* Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301 USA.
*
* Authors: Roberto Majadas <roberto.majadas@openshine.com>
* Bastien Nocera <hadess@hadess.net>
*/
#ifndef _CAJA_SENDTO_PLUGIN_H_
#define _CAJA_SENDTO_PLUGIN_H_
#include <gmodule.h>
#include <gtk/gtk.h>
/**
* SECTION:caja-sendto-plugin
* @short_description: caja-sento plug-in
* @stability: Stable
* @include: bluetooth-plugin.h
*
* Plug-ins can be used to extend caja-sendto.
**/
typedef struct _NstPluginInfo NstPluginInfo;
typedef struct _NstPlugin NstPlugin;
/**
* NstPluginCapabilities:
* @CAJA_CAPS_NONE: No capabilities
* @CAJA_CAPS_SEND_DIRECTORIES: The plugin can send whole directories without compression
* @CAJA_CAPS_SEND_IMAGES: The plugin only sends images which could be resized
*
* Capabilities of the plugin.
**/
typedef enum {
CAJA_CAPS_NONE = 0,
CAJA_CAPS_SEND_DIRECTORIES = 1 << 0,
CAJA_CAPS_SEND_IMAGES = 1 << 1,
} NstPluginCapabilities;
/**
* NstPluginInfo:
* @icon: The icon name for the plugin selection drop-down
* @id: A unique ID representing the plugin
* @description: The label used in the plugin selection drop-down
* @gettext_package: The domain to use to translate the description, %NULL if the plugin is part of caja-sendto
* @capabilities: a bitmask of #NstPluginCapabilities
* @init: Check for dependencies, and return %FALSE if dependencies such as programs are missing.
* @get_contacts_widget: Return the contact widget, the widget to select the destination of the files
* @validate_destination: Validate whether the destination can receive the file. This callback is optional.
* @send_files: Actually send the files to the selected destination. The file list is a #GList of URI strings.
* @destroy: Free all the resources used by the plugin.
*
* A structure representing a caja-sendto plugin. You should also call NST_INIT_PLUGIN() on the plugin structure to export it.
**/
struct _NstPluginInfo
{
gchar *icon;
gchar *id;
gchar *description;
gchar *gettext_package;
NstPluginCapabilities capabilities;
gboolean (*init) (NstPlugin *plugin);
GtkWidget* (*get_contacts_widget) (NstPlugin *plugin);
gboolean (*validate_destination) (NstPlugin *plugin, GtkWidget *contact_widget, char **error);
gboolean (*send_files) (NstPlugin *plugin,
GtkWidget *contact_widget,
GList *file_list);
gboolean (*destroy) (NstPlugin *plugin) ;
};
/**
* NstPlugin:
* @module: the #GModule for the opened shared library
* @info: a #NstPluginInfo structure
*
* A structure as used in caja-sendto.
**/
struct _NstPlugin
{
GModule *module;
NstPluginInfo *info;
};
/**
* NST_INIT_PLUGIN:
* @plugininfo: a #NstPluginInfo structure representing the plugin
*
* Call this on an #NstPluginInfo structure to make it available to caja-sendto.
**/
# define NST_INIT_PLUGIN(plugininfo) \
gboolean nst_init_plugin(NstPlugin *plugin); \
G_MODULE_EXPORT gboolean nst_init_plugin(NstPlugin *plugin) { \
plugin->info = &(plugininfo); \
return TRUE; \
}
#endif /* _CAJA_SENDTO_PLUGIN_H_ */
|
