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
|
/* vi:set et ai sw=2 sts=2 ts=2: */
/*-
* Copyright (c) 2005-2006 Benedikt Meurer <benny@xfce.org>
*
* 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., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
#ifdef HAVE_CONFIG_H
#include <config.h>
#endif
#include <thunarx/thunarx-renamer-provider.h>
#include <thunarx/thunarx-private.h>
/**
* SECTION: thunarx-renamer-provider
* @short_description: The interface to extensions that provide additional bulk renamers
* @title: ThunarxRenamerProvider
* @include: thunarx/thunarx.h
*
* The <interface>ThunarxRenamerProvider</interface> interface is implemented by
* extensions which provide additional bulk renamers that should be used by the
* bulk rename dialog in Thunar.
*/
GType
thunarx_renamer_provider_get_type (void)
{
static volatile gsize type__volatile = 0;
GType type;
if (g_once_init_enter (&type__volatile))
{
type = g_type_register_static_simple (G_TYPE_INTERFACE,
I_("ThunarxRenamerProvider"),
sizeof (ThunarxRenamerProviderIface),
NULL,
0,
NULL,
0);
g_type_interface_add_prerequisite (type, G_TYPE_OBJECT);
g_once_init_leave (&type__volatile, type);
}
return type__volatile;
}
/**
* thunarx_renamer_provider_get_renamers: (skip)
* @provider : a #ThunarxRenamerProvider.
*
* Returns the list of #ThunarxRenamer<!---->s provided by the
* specified @provider.
*
* The real implementation of this method MUST return the #ThunarxRenamer<!---->s
* with floating references (the default for g_object_new() on #GtkWidget
* derived types).
*
* The returned #ThunarxRenamer<!---->s will be reffed and sinked automatically
* by this function.
*
* As a special note, this method automatically takes a reference on the
* @provider for every #ThunarxRenamer returned from the real implementation
* of this method in @provider. This is to make sure that the extension stays
* in memory for atleast the time that the renamers are used. If the extension
* wants to stay in memory for a longer time, it'll need to take care of this
* itself (e.g. by taking an additional reference on the @provider itself,
* that's released at a later time).
*
* The caller is responsible to free the returned list of renamers using
* something like this when no longer needed:
* <informalexample><programlisting>
* g_list_free_full (list, g_object_unref);
* </programlisting></informalexample>
*
* Returns: (transfer full) (element-type ThunarxRenamer): the list of #ThunarxRenamer<!---->s provided by the
* specified @provider.
**/
GList*
thunarx_renamer_provider_get_renamers (ThunarxRenamerProvider *provider)
{
GList *renamers;
GList *lp;
g_return_val_if_fail (THUNARX_IS_RENAMER_PROVIDER (provider), NULL);
/* determine the renamers from the real implementation */
renamers = (*THUNARX_RENAMER_PROVIDER_GET_IFACE (provider)->get_renamers) (provider);
/* ref&sink all returned renamers */
for (lp = renamers; lp != NULL; lp = lp->next)
g_object_ref_sink (G_OBJECT (lp->data));
/* take a reference for all renamers on the provider */
thunarx_object_list_take_reference (renamers, provider);
/* and return the list of renamers */
return renamers;
}
|
