86ea351bd7
2007-03-14 Emmanuele Bassi <ebassi@gnome.org> Various clean ups in the GtkRecent code. (see #338843) * gtk/gtkrecentchooserdefault.c: * gtk/gtkrecentchoosermenu.c: * gtk/gtkrecentchooserprivate.h: * gtk/gtkrecentchooserutils.c: Move the recent chooser function for getting the sorted and clamped list of recent files from the manager outside the implementations. * gtk/gtkrecentchooserdefault.c (chooser_set_sort_type): Repopulate the list when the sorting order changes. (gtk_recent_chooser_default_dispose), (gtk_recent_chooser_default_finalize): Move object unref and source removal from finalize to dispose. * gtk/gtkrecentchooser.c (gtk_recent_chooser_type_init): Relax the prerequisite for the GtkRecentChooser interface implementations, from GtkObject to GObject. (gtk_recent_chooser_class_init): Use GTK_PARAM_* instead of G_PARAM_* svn path=/trunk/; revision=17514
433 lines
13 KiB
C
433 lines
13 KiB
C
/* gtkrecentchooserutils.h - Private utility functions for implementing a
|
|
* GtkRecentChooser interface
|
|
*
|
|
* Copyright (C) 2006 Emmanuele Bassi
|
|
*
|
|
* All rights reserved
|
|
*
|
|
* 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.
|
|
*
|
|
* Based on gtkfilechooserutils.c:
|
|
* Copyright (C) 2003 Red Hat, Inc.
|
|
*/
|
|
|
|
#include "config.h"
|
|
|
|
#include "gtkrecentchooserutils.h"
|
|
#include "gtkalias.h"
|
|
|
|
/* Methods */
|
|
static void delegate_set_sort_func (GtkRecentChooser *chooser,
|
|
GtkRecentSortFunc sort_func,
|
|
gpointer sort_data,
|
|
GDestroyNotify data_destroy);
|
|
static void delegate_add_filter (GtkRecentChooser *chooser,
|
|
GtkRecentFilter *filter);
|
|
static void delegate_remove_filter (GtkRecentChooser *chooser,
|
|
GtkRecentFilter *filter);
|
|
static GSList *delegate_list_filters (GtkRecentChooser *chooser);
|
|
static gboolean delegate_select_uri (GtkRecentChooser *chooser,
|
|
const gchar *uri,
|
|
GError **error);
|
|
static void delegate_unselect_uri (GtkRecentChooser *chooser,
|
|
const gchar *uri);
|
|
static GList *delegate_get_items (GtkRecentChooser *chooser);
|
|
static GtkRecentManager *delegate_get_recent_manager (GtkRecentChooser *chooser);
|
|
static void delegate_select_all (GtkRecentChooser *chooser);
|
|
static void delegate_unselect_all (GtkRecentChooser *chooser);
|
|
static gboolean delegate_set_current_uri (GtkRecentChooser *chooser,
|
|
const gchar *uri,
|
|
GError **error);
|
|
static gchar * delegate_get_current_uri (GtkRecentChooser *chooser);
|
|
|
|
/* Signals */
|
|
static void delegate_notify (GObject *object,
|
|
GParamSpec *pspec,
|
|
gpointer user_data);
|
|
static void delegate_selection_changed (GtkRecentChooser *receiver,
|
|
gpointer user_data);
|
|
static void delegate_item_activated (GtkRecentChooser *receiver,
|
|
gpointer user_data);
|
|
|
|
/**
|
|
* _gtk_recent_chooser_install_properties:
|
|
* @klass: the class structure for a type deriving from #GObject
|
|
*
|
|
* Installs the necessary properties for a class implementing
|
|
* #GtkRecentChooser. A #GtkParamSpecOverride property is installed
|
|
* for each property, using the values from the #GtkRecentChooserProp
|
|
* enumeration. The caller must make sure itself that the enumeration
|
|
* values don't collide with some other property values they
|
|
* are using.
|
|
*/
|
|
void
|
|
_gtk_recent_chooser_install_properties (GObjectClass *klass)
|
|
{
|
|
g_object_class_override_property (klass,
|
|
GTK_RECENT_CHOOSER_PROP_RECENT_MANAGER,
|
|
"recent-manager");
|
|
g_object_class_override_property (klass,
|
|
GTK_RECENT_CHOOSER_PROP_SHOW_PRIVATE,
|
|
"show-private");
|
|
g_object_class_override_property (klass,
|
|
GTK_RECENT_CHOOSER_PROP_SHOW_TIPS,
|
|
"show-tips");
|
|
g_object_class_override_property (klass,
|
|
GTK_RECENT_CHOOSER_PROP_SHOW_ICONS,
|
|
"show-icons");
|
|
g_object_class_override_property (klass,
|
|
GTK_RECENT_CHOOSER_PROP_SHOW_NOT_FOUND,
|
|
"show-not-found");
|
|
g_object_class_override_property (klass,
|
|
GTK_RECENT_CHOOSER_PROP_SELECT_MULTIPLE,
|
|
"select-multiple");
|
|
g_object_class_override_property (klass,
|
|
GTK_RECENT_CHOOSER_PROP_LIMIT,
|
|
"limit");
|
|
g_object_class_override_property (klass,
|
|
GTK_RECENT_CHOOSER_PROP_LOCAL_ONLY,
|
|
"local-only");
|
|
g_object_class_override_property (klass,
|
|
GTK_RECENT_CHOOSER_PROP_SORT_TYPE,
|
|
"sort-type");
|
|
g_object_class_override_property (klass,
|
|
GTK_RECENT_CHOOSER_PROP_FILTER,
|
|
"filter");
|
|
}
|
|
|
|
/**
|
|
* _gtk_recent_chooser_delegate_iface_init:
|
|
* @iface: a #GtkRecentChooserIface
|
|
*
|
|
* An interface-initialization function for use in cases where
|
|
* an object is simply delegating the methods, signals of
|
|
* the #GtkRecentChooser interface to another object.
|
|
* _gtk_recent_chooser_set_delegate() must be called on each
|
|
* instance of the object so that the delegate object can
|
|
* be found.
|
|
*/
|
|
void
|
|
_gtk_recent_chooser_delegate_iface_init (GtkRecentChooserIface *iface)
|
|
{
|
|
iface->set_current_uri = delegate_set_current_uri;
|
|
iface->get_current_uri = delegate_get_current_uri;
|
|
iface->select_uri = delegate_select_uri;
|
|
iface->unselect_uri = delegate_unselect_uri;
|
|
iface->select_all = delegate_select_all;
|
|
iface->unselect_all = delegate_unselect_all;
|
|
iface->get_items = delegate_get_items;
|
|
iface->get_recent_manager = delegate_get_recent_manager;
|
|
iface->set_sort_func = delegate_set_sort_func;
|
|
iface->add_filter = delegate_add_filter;
|
|
iface->remove_filter = delegate_remove_filter;
|
|
iface->list_filters = delegate_list_filters;
|
|
}
|
|
|
|
/**
|
|
* _gtk_recent_chooser_set_delegate:
|
|
* @receiver: a #GObject implementing #GtkRecentChooser
|
|
* @delegate: another #GObject implementing #GtkRecentChooser
|
|
*
|
|
* Establishes that calls on @receiver for #GtkRecentChooser
|
|
* methods should be delegated to @delegate, and that
|
|
* #GtkRecentChooser signals emitted on @delegate should be
|
|
* forwarded to @receiver. Must be used in conjunction with
|
|
* _gtk_recent_chooser_delegate_iface_init().
|
|
*/
|
|
void
|
|
_gtk_recent_chooser_set_delegate (GtkRecentChooser *receiver,
|
|
GtkRecentChooser *delegate)
|
|
{
|
|
g_return_if_fail (GTK_IS_RECENT_CHOOSER (receiver));
|
|
g_return_if_fail (GTK_IS_RECENT_CHOOSER (delegate));
|
|
|
|
g_object_set_data (G_OBJECT (receiver),
|
|
"gtk-recent-chooser-delegate", delegate);
|
|
|
|
g_signal_connect (delegate, "notify",
|
|
G_CALLBACK (delegate_notify), receiver);
|
|
g_signal_connect (delegate, "selection-changed",
|
|
G_CALLBACK (delegate_selection_changed), receiver);
|
|
g_signal_connect (delegate, "item_activated",
|
|
G_CALLBACK (delegate_item_activated), receiver);
|
|
}
|
|
|
|
GQuark
|
|
_gtk_recent_chooser_delegate_get_quark (void)
|
|
{
|
|
static GQuark quark = 0;
|
|
|
|
if (G_UNLIKELY (quark == 0))
|
|
quark = g_quark_from_static_string ("gtk-recent-chooser-delegate");
|
|
|
|
return quark;
|
|
}
|
|
|
|
static GtkRecentChooser *
|
|
get_delegate (GtkRecentChooser *receiver)
|
|
{
|
|
return g_object_get_qdata (G_OBJECT (receiver),
|
|
GTK_RECENT_CHOOSER_DELEGATE_QUARK);
|
|
}
|
|
|
|
static void
|
|
delegate_set_sort_func (GtkRecentChooser *chooser,
|
|
GtkRecentSortFunc sort_func,
|
|
gpointer sort_data,
|
|
GDestroyNotify data_destroy)
|
|
{
|
|
gtk_recent_chooser_set_sort_func (get_delegate (chooser),
|
|
sort_func,
|
|
sort_data,
|
|
data_destroy);
|
|
}
|
|
|
|
static void
|
|
delegate_add_filter (GtkRecentChooser *chooser,
|
|
GtkRecentFilter *filter)
|
|
{
|
|
gtk_recent_chooser_add_filter (get_delegate (chooser), filter);
|
|
}
|
|
|
|
static void
|
|
delegate_remove_filter (GtkRecentChooser *chooser,
|
|
GtkRecentFilter *filter)
|
|
{
|
|
gtk_recent_chooser_remove_filter (get_delegate (chooser), filter);
|
|
}
|
|
|
|
static GSList *
|
|
delegate_list_filters (GtkRecentChooser *chooser)
|
|
{
|
|
return gtk_recent_chooser_list_filters (get_delegate (chooser));
|
|
}
|
|
|
|
static gboolean
|
|
delegate_select_uri (GtkRecentChooser *chooser,
|
|
const gchar *uri,
|
|
GError **error)
|
|
{
|
|
return gtk_recent_chooser_select_uri (get_delegate (chooser), uri, error);
|
|
}
|
|
|
|
static void
|
|
delegate_unselect_uri (GtkRecentChooser *chooser,
|
|
const gchar *uri)
|
|
{
|
|
gtk_recent_chooser_unselect_uri (get_delegate (chooser), uri);
|
|
}
|
|
|
|
static GList *
|
|
delegate_get_items (GtkRecentChooser *chooser)
|
|
{
|
|
return gtk_recent_chooser_get_items (get_delegate (chooser));
|
|
}
|
|
|
|
static GtkRecentManager *
|
|
delegate_get_recent_manager (GtkRecentChooser *chooser)
|
|
{
|
|
return _gtk_recent_chooser_get_recent_manager (get_delegate (chooser));
|
|
}
|
|
|
|
static void
|
|
delegate_select_all (GtkRecentChooser *chooser)
|
|
{
|
|
gtk_recent_chooser_select_all (get_delegate (chooser));
|
|
}
|
|
|
|
static void
|
|
delegate_unselect_all (GtkRecentChooser *chooser)
|
|
{
|
|
gtk_recent_chooser_unselect_all (get_delegate (chooser));
|
|
}
|
|
|
|
static gboolean
|
|
delegate_set_current_uri (GtkRecentChooser *chooser,
|
|
const gchar *uri,
|
|
GError **error)
|
|
{
|
|
return gtk_recent_chooser_set_current_uri (get_delegate (chooser), uri, error);
|
|
}
|
|
|
|
static gchar *
|
|
delegate_get_current_uri (GtkRecentChooser *chooser)
|
|
{
|
|
return gtk_recent_chooser_get_current_uri (get_delegate (chooser));
|
|
}
|
|
|
|
static void
|
|
delegate_notify (GObject *object,
|
|
GParamSpec *pspec,
|
|
gpointer user_data)
|
|
{
|
|
gpointer iface;
|
|
|
|
iface = g_type_interface_peek (g_type_class_peek (G_OBJECT_TYPE (object)),
|
|
gtk_recent_chooser_get_type ());
|
|
if (g_object_interface_find_property (iface, pspec->name))
|
|
g_object_notify (user_data, pspec->name);
|
|
}
|
|
|
|
static void
|
|
delegate_selection_changed (GtkRecentChooser *receiver,
|
|
gpointer user_data)
|
|
{
|
|
_gtk_recent_chooser_selection_changed (GTK_RECENT_CHOOSER (user_data));
|
|
}
|
|
|
|
static void
|
|
delegate_item_activated (GtkRecentChooser *receiver,
|
|
gpointer user_data)
|
|
{
|
|
_gtk_recent_chooser_item_activated (GTK_RECENT_CHOOSER (user_data));
|
|
}
|
|
|
|
static gint
|
|
sort_recent_items_mru (GtkRecentInfo *a,
|
|
GtkRecentInfo *b,
|
|
gpointer unused)
|
|
{
|
|
g_assert (a != NULL && b != NULL);
|
|
|
|
return (gtk_recent_info_get_modified (a) < gtk_recent_info_get_modified (b));
|
|
}
|
|
|
|
static gint
|
|
sort_recent_items_lru (GtkRecentInfo *a,
|
|
GtkRecentInfo *b,
|
|
gpointer unused)
|
|
{
|
|
g_assert (a != NULL && b != NULL);
|
|
|
|
return (gtk_recent_info_get_modified (a) > gtk_recent_info_get_modified (b));
|
|
}
|
|
|
|
typedef struct
|
|
{
|
|
GtkRecentSortFunc func;
|
|
gpointer data;
|
|
} SortRecentData;
|
|
|
|
/* our proxy sorting function */
|
|
static gint
|
|
sort_recent_items_proxy (gpointer *a,
|
|
gpointer *b,
|
|
gpointer user_data)
|
|
{
|
|
GtkRecentInfo *info_a = (GtkRecentInfo *) a;
|
|
GtkRecentInfo *info_b = (GtkRecentInfo *) b;
|
|
SortRecentData *sort_recent = user_data;
|
|
|
|
if (sort_recent->func)
|
|
return (* sort_recent->func) (info_a,
|
|
info_b,
|
|
sort_recent->data);
|
|
|
|
/* fallback */
|
|
return 0;
|
|
}
|
|
|
|
/*
|
|
* _gtk_recent_chooser_get_items:
|
|
* @chooser: a #GtkRecentChooser
|
|
* @sort_func: sorting function, or %NULL
|
|
* @sort_data: sorting function data, or %NULL
|
|
*
|
|
* Default implementation for getting the (sorted and clamped) list
|
|
* of recently used resources from a #GtkRecentChooser. This function
|
|
* should be used by implementations of the #GtkRecentChooser
|
|
* interface inside the GtkRecentChooser::get_items vfunc.
|
|
*
|
|
* Return value: a list of #GtkRecentInfo objects
|
|
*/
|
|
GList *
|
|
_gtk_recent_chooser_get_items (GtkRecentChooser *chooser,
|
|
GtkRecentSortFunc sort_func,
|
|
gpointer sort_data)
|
|
{
|
|
GtkRecentManager *manager;
|
|
gint limit;
|
|
GtkRecentSortType sort_type;
|
|
GList *items;
|
|
GCompareDataFunc compare_func;
|
|
gint length;
|
|
|
|
g_return_val_if_fail (GTK_IS_RECENT_CHOOSER (chooser), NULL);
|
|
|
|
manager = _gtk_recent_chooser_get_recent_manager (chooser);
|
|
if (!manager)
|
|
return NULL;
|
|
|
|
items = gtk_recent_manager_get_items (manager);
|
|
if (!items)
|
|
return NULL;
|
|
|
|
limit = gtk_recent_chooser_get_limit (chooser);
|
|
if (limit == 0)
|
|
return NULL;
|
|
|
|
sort_type = gtk_recent_chooser_get_sort_type (chooser);
|
|
switch (sort_type)
|
|
{
|
|
case GTK_RECENT_SORT_NONE:
|
|
compare_func = NULL;
|
|
break;
|
|
case GTK_RECENT_SORT_MRU:
|
|
compare_func = (GCompareDataFunc) sort_recent_items_mru;
|
|
break;
|
|
case GTK_RECENT_SORT_LRU:
|
|
compare_func = (GCompareDataFunc) sort_recent_items_lru;
|
|
break;
|
|
case GTK_RECENT_SORT_CUSTOM:
|
|
compare_func = (GCompareDataFunc) sort_recent_items_proxy;
|
|
break;
|
|
default:
|
|
g_assert_not_reached ();
|
|
break;
|
|
}
|
|
|
|
if (compare_func)
|
|
{
|
|
SortRecentData *sort_recent;
|
|
|
|
sort_recent = g_slice_new (SortRecentData);
|
|
sort_recent->func = sort_func;
|
|
sort_recent->data = sort_data;
|
|
|
|
items = g_list_sort_with_data (items, compare_func, sort_recent);
|
|
|
|
g_slice_free (SortRecentData, sort_recent);
|
|
}
|
|
|
|
length = g_list_length (items);
|
|
if ((limit != -1) && (length > limit))
|
|
{
|
|
GList *clamp, *l;
|
|
|
|
clamp = g_list_nth (items, limit - 1);
|
|
if (!clamp)
|
|
return items;
|
|
|
|
l = clamp->next;
|
|
clamp->next = NULL;
|
|
|
|
g_list_foreach (l, (GFunc) gtk_recent_info_unref, NULL);
|
|
g_list_free (l);
|
|
}
|
|
|
|
return items;
|
|
}
|