/* GTK - The GIMP Toolkit

 * gtkrecentchooser.c - Abstract interface for recent file selectors GUIs

 *

 * Copyright (C) 2006, Emmanuele Bassi

 * 

 * This library is free software; you can redistribute it and/or

 * modify it under the terms of the GNU Lesser 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

 * Lesser General Public License for more details.

 *

 * You should have received a copy of the GNU Lesser 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.

 */

#include "config.h"

#include "gtkrecentchooser.h"

#include "gtkrecentchooserprivate.h"

#include "gtkrecentmanager.h"

#include "gtkrecentaction.h"

#include "gtkactivatable.h"

#include "gtkintl.h"

#include "gtktypebuiltins.h"

#include "gtkprivate.h"

#include "gtkmarshalers.h"

#include "gtkalias.h"

enum

{

  ITEM_ACTIVATED,

  SELECTION_CHANGED,

  LAST_SIGNAL

};

static void     gtk_recent_chooser_class_init         (gpointer          g_iface);

static gboolean recent_chooser_has_show_numbers       (GtkRecentChooser *chooser);

static GQuark      quark_gtk_related_action               = 0;

static GQuark      quark_gtk_use_action_appearance        = 0;

static const gchar gtk_related_action_key[]               = "gtk-related-action";

static const gchar gtk_use_action_appearance_key[]        = "gtk-use-action-appearance";

static guint chooser_signals[LAST_SIGNAL] = { 0, };

GType

gtk_recent_chooser_get_type (void)

{

  static GType chooser_type = 0;

  if (!chooser_type)

    {

      chooser_type = g_type_register_static_simple (G_TYPE_INTERFACE,

						    I_("GtkRecentChooser"),

						    sizeof (GtkRecentChooserIface),

						    (GClassInitFunc) gtk_recent_chooser_class_init,

						    0, NULL, 0);

      g_type_interface_add_prerequisite (chooser_type, G_TYPE_OBJECT);

    }

  return chooser_type;

}

static void

gtk_recent_chooser_class_init (gpointer g_iface)

{

  GType iface_type = G_TYPE_FROM_INTERFACE (g_iface);

  quark_gtk_related_action        = g_quark_from_static_string (gtk_related_action_key);

  quark_gtk_use_action_appearance = g_quark_from_static_string (gtk_use_action_appearance_key);

  /**

   * GtkRecentChooser::selection-changed

   * @chooser: the object which received the signal

   *

   * This signal is emitted when there is a change in the set of

   * selected recently used resources.  This can happen when a user

   * modifies the selection with the mouse or the keyboard, or when

   * explicitely calling functions to change the selection.

   *

   * Since: 2.10

   */

  chooser_signals[SELECTION_CHANGED] =

    g_signal_new (I_("selection-changed"),

                  iface_type,

                  G_SIGNAL_RUN_LAST,

                  G_STRUCT_OFFSET (GtkRecentChooserIface, selection_changed),

                  NULL, NULL,

                  g_cclosure_marshal_VOID__VOID,

                  G_TYPE_NONE, 0);

  /**

   * GtkRecentChooser::item-activated

   * @chooser: the object which received the signal

   *

   * This signal is emitted when the user "activates" a recent item

   * in the recent chooser.  This can happen by double-clicking on an item

   * in the recently used resources list, or by pressing

   * <keycap>Enter</keycap>.

   *

   * Since: 2.10

   */

  chooser_signals[ITEM_ACTIVATED] =

    g_signal_new (I_("item-activated"),

                  iface_type,

		  G_SIGNAL_RUN_LAST,

		  G_STRUCT_OFFSET (GtkRecentChooserIface, item_activated),

		  NULL, NULL,

		  g_cclosure_marshal_VOID__VOID,

		  G_TYPE_NONE, 0);

  /**

   * GtkRecentChooser:recent-manager:

   *

   * The #GtkRecentManager instance used by the #GtkRecentChooser to

   * display the list of recently used resources.

   *

   * Since: 2.10

   */

  g_object_interface_install_property (g_iface,

  				       g_param_spec_object ("recent-manager",

  				       			    P_("Recent Manager"),

  				       			    P_("The RecentManager object to use"),

  				       			    GTK_TYPE_RECENT_MANAGER,

  				       			    GTK_PARAM_WRITABLE | G_PARAM_CONSTRUCT_ONLY));

  /**

   * GtkRecentManager:show-private:

   *

   * Whether this #GtkRecentChooser should display recently used resources

   * marked with the "private" flag. Such resources should be considered

   * private to the applications and groups that have added them.

   *

   * Since: 2.10

   */

  g_object_interface_install_property (g_iface,

   				       g_param_spec_boolean ("show-private",

   							     P_("Show Private"),

   							     P_("Whether the private items should be displayed"),

   							     FALSE,

   							     GTK_PARAM_READWRITE));

  /**

   * GtkRecentChooser:show-tips:

   *

   * Whether this #GtkRecentChooser should display a tooltip containing the

   * full path of the recently used resources.

   *

   * Since: 2.10

   */

  g_object_interface_install_property (g_iface,

  				       g_param_spec_boolean ("show-tips",

  				       			     P_("Show Tooltips"),

  				       			     P_("Whether there should be a tooltip on the item"),

  				       			     FALSE,

  				       			     GTK_PARAM_READWRITE));

  /**

   * GtkRecentChooser:show-icons:

   *

   * Whether this #GtkRecentChooser should display an icon near the item.

   *

   * Since: 2.10

   */

  g_object_interface_install_property (g_iface,

  				       g_param_spec_boolean ("show-icons",

  				       			     P_("Show Icons"),

  				       			     P_("Whether there should be an icon near the item"),

  				       			     TRUE,

  				       			     GTK_PARAM_READWRITE));

  /**

   * GtkRecentChooser:show-not-found:

   *

   * Whether this #GtkRecentChooser should display the recently used resources

   * even if not present anymore. Setting this to %FALSE will perform a

   * potentially expensive check on every local resource (every remote

   * resource will always be displayed).

   *

   * Since: 2.10

   */

  g_object_interface_install_property (g_iface,

  				       g_param_spec_boolean ("show-not-found",

  				       			     P_("Show Not Found"),

  				       			     P_("Whether the items pointing to unavailable resources should be displayed"),

  				       			     TRUE,

  				       			     GTK_PARAM_READWRITE));

  /**

   * GtkRecentChooser:select-multiple:

   *

   * Allow the user to select multiple resources.

   *

   * Since: 2.10

   */

  g_object_interface_install_property (g_iface,

   				       g_param_spec_boolean ("select-multiple",

   							     P_("Select Multiple"),

   							     P_("Whether to allow multiple items to be selected"),

   							     FALSE,

   							     GTK_PARAM_READWRITE));

  /**

   * GtkRecentChooser:local-only:

   *

   * Whether this #GtkRecentChooser should display only local (file:)

   * resources.

   *

   * Since: 2.10

   */

  g_object_interface_install_property (g_iface,

		  		       g_param_spec_boolean ("local-only",

					       		     P_("Local only"),

							     P_("Whether the selected resource(s) should be limited to local file: URIs"),

							     TRUE,

							     GTK_PARAM_READWRITE));

  /**

   * GtkRecentChooser:limit:

   *

   * The maximum number of recently used resources to be displayed,

   * or -1 to display all items. By default, the

   * GtkSetting:gtk-recent-files-limit setting is respected: you can

   * override that limit on a particular instance of #GtkRecentChooser

   * by setting this property.

   *

   * Since: 2.10

   */

  g_object_interface_install_property (g_iface,

   				       g_param_spec_int ("limit",

   							 P_("Limit"),

   							 P_("The maximum number of items to be displayed"),

   							 -1,

   							 G_MAXINT,

   							 -1,

   							 GTK_PARAM_READWRITE));

  /**

   * GtkRecentChooser:sort-type:

   *

   * Sorting order to be used when displaying the recently used resources.

   *

   * Since: 2.10

   */

  g_object_interface_install_property (g_iface,

		  		       g_param_spec_enum ("sort-type",

					       		  P_("Sort Type"),

							  P_("The sorting order of the items displayed"),

							  GTK_TYPE_RECENT_SORT_TYPE,

							  GTK_RECENT_SORT_NONE,

							  GTK_PARAM_READWRITE));

  /**

   * GtkRecentChooser:filter:

   *

   * The #GtkRecentFilter object to be used when displaying

   * the recently used resources.

   *

   * Since: 2.10

   */

  g_object_interface_install_property (g_iface,

  				       g_param_spec_object ("filter",

  				       			    P_("Filter"),

  				       			    P_("The current filter for selecting which resources are displayed"),

  				       			    GTK_TYPE_RECENT_FILTER,

  				       			    GTK_PARAM_READWRITE));

}

GQuark

gtk_recent_chooser_error_quark (void)

{

  return g_quark_from_static_string ("gtk-recent-chooser-error-quark");

}

/**

 * _gtk_recent_chooser_get_recent_manager:

 * @chooser: a #GtkRecentChooser

 *

 * Gets the #GtkRecentManager used by @chooser.

 *

 * Return value: the recent manager for @chooser.

 *

 * Since: 2.10

 */

GtkRecentManager *

_gtk_recent_chooser_get_recent_manager (GtkRecentChooser *chooser)

{

  g_return_val_if_fail (GTK_IS_RECENT_CHOOSER (chooser), NULL);

  return GTK_RECENT_CHOOSER_GET_IFACE (chooser)->get_recent_manager (chooser);

}

/**

 * gtk_recent_chooser_set_show_private:

 * @chooser: a #GtkRecentChooser

 * @show_private: %TRUE to show private items, %FALSE otherwise

 *

 * Whether to show recently used resources marked registered as private.

 *

 * Since: 2.10

 */

void

gtk_recent_chooser_set_show_private (GtkRecentChooser *chooser,

				     gboolean          show_private)

{

  g_return_if_fail (GTK_IS_RECENT_CHOOSER (chooser));

  g_object_set (chooser, "show-private", show_private, NULL);

}

/**

 * gtk_recent_chooser_get_show_private:

 * @chooser: a #GtkRecentChooser

 *

 * Returns whether @chooser should display recently used resources

 * registered as private.

 *

 * Return value: %TRUE if the recent chooser should show private items,

 *   %FALSE otherwise.

 *

 * Since: 2.10

 */

gboolean

gtk_recent_chooser_get_show_private (GtkRecentChooser *chooser)

{

  gboolean show_private;

  g_return_val_if_fail (GTK_IS_RECENT_CHOOSER (chooser), FALSE);

  g_object_get (chooser, "show-private", &show_private, NULL);

  return show_private;

}

/**

 * gtk_recent_chooser_set_show_not_found:

 * @chooser: a #GtkRecentChooser

 * @show_not_found: whether to show the local items we didn't find

 *

 * Sets whether @chooser should display the recently used resources that

 * it didn't find.  This only applies to local resources.

 *

 * Since: 2.10

 */

void

gtk_recent_chooser_set_show_not_found (GtkRecentChooser *chooser,

				       gboolean          show_not_found)

{

  g_return_if_fail (GTK_IS_RECENT_CHOOSER (chooser));

  g_object_set (chooser, "show-not-found", show_not_found, NULL);

}

/**

 * gtk_recent_chooser_get_show_not_found:

 * @chooser: a #GtkRecentChooser

 *

 * Retrieves whether @chooser should show the recently used resources that

 * were not found.

 *

 * Return value: %TRUE if the resources not found should be displayed, and

 *   %FALSE otheriwse.

 *

 * Since: 2.10

 */

gboolean

gtk_recent_chooser_get_show_not_found (GtkRecentChooser *chooser)

{

  gboolean show_not_found;

  g_return_val_if_fail (GTK_IS_RECENT_CHOOSER (chooser), FALSE);

  g_object_get (chooser, "show-not-found", &show_not_found, NULL);

  return show_not_found;

}

/**

 * gtk_recent_chooser_set_show_icons:

 * @chooser: a #GtkRecentChooser

 * @show_icons: whether to show an icon near the resource

 *

 * Sets whether @chooser should show an icon near the resource when

 * displaying it.

 *

 * Since: 2.10

 */

void

gtk_recent_chooser_set_show_icons (GtkRecentChooser *chooser,

				   gboolean          show_icons)

{

  g_return_if_fail (GTK_IS_RECENT_CHOOSER (chooser));

  g_object_set (chooser, "show-icons", show_icons, NULL);

}

/**

 * gtk_recent_chooser_get_show_icons:

 * @chooser: a #GtkRecentChooser

 *

 * Retrieves whether @chooser should show an icon near the resource.

 *

 * Return value: %TRUE if the icons should be displayed, %FALSE otherwise.

 *

 * Since: 2.10

 */

gboolean

gtk_recent_chooser_get_show_icons (GtkRecentChooser *chooser)

{

  gboolean show_icons;

  g_return_val_if_fail (GTK_IS_RECENT_CHOOSER (chooser), FALSE);

  g_object_get (chooser, "show-icons", &show_icons, NULL);

  return show_icons;

}

/**

 * gtk_recent_chooser_set_select_multiple:

 * @chooser: a #GtkRecentChooser

 * @select_multiple: %TRUE if @chooser can select more than one item

 *

 * Sets whether @chooser can select multiple items.

 *

 * Since: 2.10

 */

void

gtk_recent_chooser_set_select_multiple (GtkRecentChooser *chooser,

					gboolean          select_multiple)

{

  g_return_if_fail (GTK_IS_RECENT_CHOOSER (chooser));

  g_object_set (chooser, "select-multiple", select_multiple, NULL);

}

/**

 * gtk_recent_chooser_get_select_multiple:

 * @chooser: a #GtkRecentChooser

 *

 * Gets whether @chooser can select multiple items.

 *

 * Return value: %TRUE if @chooser can select more than one item.

 *

 * Since: 2.10

 */

gboolean

gtk_recent_chooser_get_select_multiple (GtkRecentChooser *chooser)

{

  gboolean select_multiple;

  g_return_val_if_fail (GTK_IS_RECENT_CHOOSER (chooser), FALSE);

  g_object_get (chooser, "select-multiple", &select_multiple, NULL);

  return select_multiple;

}

/**

 * gtk_recent_chooser_set_local_only:

 * @chooser: a #GtkRecentChooser

 * @local_only: %TRUE if only local files can be shown

 * 

 * Sets whether only local resources, that is resources using the file:// URI

 * scheme, should be shown in the recently used resources selector.  If

 * @local_only is %TRUE (the default) then the shown resources are guaranteed

 * to be accessible through the operating system native file system.

 *

 * Since: 2.10

 */

void

gtk_recent_chooser_set_local_only (GtkRecentChooser *chooser,

				   gboolean          local_only)

{

  g_return_if_fail (GTK_IS_RECENT_CHOOSER (chooser));

  g_object_set (chooser, "local-only", local_only, NULL);

}

/**

 * gtk_recent_chooser_get_local_only:

 * @chooser: a #GtkRecentChooser

 *

 * Gets whether only local resources should be shown in the recently used

 * resources selector.  See gtk_recent_chooser_set_local_only()

 *

 * Return value: %TRUE if only local resources should be shown.

 *

 * Since: 2.10

 */

gboolean

gtk_recent_chooser_get_local_only (GtkRecentChooser *chooser)

{

  gboolean local_only;

  g_return_val_if_fail (GTK_IS_RECENT_CHOOSER (chooser), FALSE);

  g_object_get (chooser, "local-only", &local_only, NULL);

  return local_only;

}

/**

 * gtk_recent_chooser_set_limit:

 * @chooser: a #GtkRecentChooser

 * @limit: a positive integer, or -1 for all items

 *

 * Sets the number of items that should be returned by

 * gtk_recent_chooser_get_items() and gtk_recent_chooser_get_uris().

 *

 * Since: 2.10

 */

void

gtk_recent_chooser_set_limit (GtkRecentChooser *chooser,

			      gint              limit)

{

  g_return_if_fail (GTK_IS_RECENT_CHOOSER (chooser));

  g_object_set (chooser, "limit", limit, NULL);

}

/**

 * gtk_recent_chooser_get_limit:

 * @chooser: a #GtkRecentChooser

 *

 * Gets the number of items returned by gtk_recent_chooser_get_items()

 * and gtk_recent_chooser_get_uris().

 *

 * Return value: A positive integer, or -1 meaning that all items are

 *   returned.

 *

 * Since: 2.10

 */

gint

gtk_recent_chooser_get_limit (GtkRecentChooser *chooser)

{

  gint limit;

  g_return_val_if_fail (GTK_IS_RECENT_CHOOSER (chooser), 10);

  g_object_get (chooser, "limit", &limit, NULL);

  return limit;

}

/**

 * gtk_recent_chooser_set_show_tips:

 * @chooser: a #GtkRecentChooser

 * @show_tips: %TRUE if tooltips should be shown

 *

 * Sets whether to show a tooltips containing the full path of each

 * recently used resource in a #GtkRecentChooser widget.

 *

 * Since: 2.10

 */

void

gtk_recent_chooser_set_show_tips (GtkRecentChooser *chooser,

				  gboolean          show_tips)

{

  g_return_if_fail (GTK_IS_RECENT_CHOOSER (chooser));

  g_object_set (chooser, "show-tips", show_tips, NULL);

}

/**

 * gtk_recent_chooser_get_show_tips:

 * @chooser: a #GtkRecentChooser

 *

 * Gets whether @chooser should display tooltips containing the full path

 * of a recently user resource.

 *

 * Return value: %TRUE if the recent chooser should show tooltips,

 *   %FALSE otherwise.

 *

 * Since: 2.10

 */

gboolean

gtk_recent_chooser_get_show_tips (GtkRecentChooser *chooser)

{

  gboolean show_tips;

  g_return_val_if_fail (GTK_IS_RECENT_CHOOSER (chooser), FALSE);

  g_object_get (chooser, "show-tips", &show_tips, NULL);

  return show_tips;

}

static gboolean

recent_chooser_has_show_numbers (GtkRecentChooser *chooser)

{

  GParamSpec *pspec;

  /* This is the result of a minor screw up: the "show-numbers" property

   * was removed from the GtkRecentChooser interface, but the accessors

   * remained in the interface API; now we need to check whether the

   * implementation of the RecentChooser interface has a "show-numbers"

   * boolean property installed before accessing it, and avoid an

   * assertion failure using a more graceful warning.  This should really

   * go away as soon as we can break API and remove these accessors.

   */

  pspec = g_object_class_find_property (G_OBJECT_GET_CLASS (chooser),

		  			"show-numbers");

  return (pspec && pspec->value_type == G_TYPE_BOOLEAN);

}

/**

 * gtk_recent_chooser_set_show_numbers:

 * @chooser: a #GtkRecentChooser

 * @show_numbers: %TRUE to show numbers, %FALSE otherwise

 *

 * Whether to show recently used resources prepended by a unique number.

 *

 * Deprecated: 2.12: Use gtk_recent_chooser_menu_set_show_numbers() instead.

 *

 * Since: 2.10

 */

void

gtk_recent_chooser_set_show_numbers (GtkRecentChooser *chooser,

				     gboolean          show_numbers)

{

  g_return_if_fail (GTK_IS_RECENT_CHOOSER (chooser));

  if (!recent_chooser_has_show_numbers (chooser))

    {

      g_warning ("Choosers of type `%s' do not support showing numbers",

		 G_OBJECT_TYPE_NAME (chooser));

      return;

    }

  g_object_set (chooser, "show-numbers", show_numbers, NULL);

}

/**

 * gtk_recent_chooser_get_show_numbers:

 * @chooser: a #GtkRecentChooser

 *

 * Returns whether @chooser should display recently used resources

 * prepended by a unique number.

 *

 * Deprecated: 2.12: use gtk_recent_chooser_menu_get_show_numbers() instead.

 *

 * Return value: %TRUE if the recent chooser should show display numbers,

 *   %FALSE otherwise.

 *

 * Since: 2.10

 */

gboolean

gtk_recent_chooser_get_show_numbers (GtkRecentChooser *chooser)

{

  GParamSpec *pspec;

  gboolean show_numbers;

  g_return_val_if_fail (GTK_IS_RECENT_CHOOSER (chooser), FALSE);

  pspec = g_object_class_find_property (G_OBJECT_GET_CLASS (chooser),

		  			"show-numbers");

  if (!pspec || pspec->value_type != G_TYPE_BOOLEAN)

    {

      g_warning ("Choosers of type `%s' do not support showing numbers",

		 G_OBJECT_TYPE_NAME (chooser));

      return FALSE;

    }

  g_object_get (chooser, "show-numbers", &show_numbers, NULL);

  return show_numbers;

}

/**

 * gtk_recent_chooser_set_sort_type:

 * @chooser: a #GtkRecentChooser

 * @sort_type: sort order that the chooser should use

 *

 * Changes the sorting order of the recently used resources list displayed by

 * @chooser.

 *

 * Since: 2.10

 */

void

gtk_recent_chooser_set_sort_type (GtkRecentChooser  *chooser,

				  GtkRecentSortType  sort_type)

{  

  g_return_if_fail (GTK_IS_RECENT_CHOOSER (chooser));

  g_object_set (chooser, "sort-type", sort_type, NULL);

}

/**

 * gtk_recent_chooser_get_sort_type:

 * @chooser: a #GtkRecentChooser

 *

 * Gets the value set by gtk_recent_chooser_set_sort_type().

 *

 * Return value: the sorting order of the @chooser.

 *

 * Since: 2.10

 */

GtkRecentSortType

gtk_recent_chooser_get_sort_type (GtkRecentChooser *chooser)

{

  GtkRecentSortType sort_type;

  g_return_val_if_fail (GTK_IS_RECENT_CHOOSER (chooser), GTK_RECENT_SORT_NONE);

  g_object_get (chooser, "sort-type", &sort_type, NULL);

  return sort_type;

}

/**

 * gtk_recent_chooser_set_sort_func:

 * @chooser: a #GtkRecentChooser

 * @sort_func: the comparison function

 * @sort_data: (allow-none): user data to pass to @sort_func, or %NULL

 * @data_destroy: (allow-none): destroy notifier for @sort_data, or %NULL

 *

 * Sets the comparison function used when sorting to be @sort_func.  If

 * the @chooser has the sort type set to #GTK_RECENT_SORT_CUSTOM then

 * the chooser will sort using this function.

 *

 * To the comparison function will be passed two #GtkRecentInfo structs and

 * @sort_data;  @sort_func should return a positive integer if the first

 * item comes before the second, zero if the two items are equal and

 * a negative integer if the first item comes after the second.

 *

 * Since: 2.10

 */

void

gtk_recent_chooser_set_sort_func  (GtkRecentChooser  *chooser,

				   GtkRecentSortFunc  sort_func,

				   gpointer           sort_data,

				   GDestroyNotify     data_destroy)

{

  g_return_if_fail (GTK_IS_RECENT_CHOOSER (chooser));

  GTK_RECENT_CHOOSER_GET_IFACE (chooser)->set_sort_func (chooser,

  							 sort_func,

  							 sort_data,

  							 data_destroy);

}

/**

 * gtk_recent_chooser_set_current_uri:

 * @chooser: a #GtkRecentChooser

 * @uri: a URI

 * @error: (allow-none): return location for a #GError, or %NULL

 *

 * Sets @uri as the current URI for @chooser.

 *

 * Return value: %TRUE if the URI was found.

 *

 * Since: 2.10

 */

gboolean

gtk_recent_chooser_set_current_uri (GtkRecentChooser  *chooser,

				    const gchar       *uri,

				    GError           **error)

{

  g_return_val_if_fail (GTK_IS_RECENT_CHOOSER (chooser), FALSE);

  return GTK_RECENT_CHOOSER_GET_IFACE (chooser)->set_current_uri (chooser, uri, error);

}

/**

 * gtk_recent_chooser_get_current_uri:

 * @chooser: a #GtkRecentChooser

 *

 * Gets the URI currently selected by @chooser.

 *

 * Return value: a newly allocated string holding a URI.

 *

 * Since: 2.10

 */

gchar *

gtk_recent_chooser_get_current_uri (GtkRecentChooser *chooser)

{

  g_return_val_if_fail (GTK_IS_RECENT_CHOOSER (chooser), NULL);

  return GTK_RECENT_CHOOSER_GET_IFACE (chooser)->get_current_uri (chooser);

}

/**

 * gtk_recent_chooser_get_current_item:

 * @chooser: a #GtkRecentChooser

 * 

 * Gets the #GtkRecentInfo currently selected by @chooser.

 *

 * Return value: a #GtkRecentInfo.  Use gtk_recent_info_unref() when

 *   when you have finished using it.

 *

 * Since: 2.10

 */

GtkRecentInfo *

gtk_recent_chooser_get_current_item (GtkRecentChooser *chooser)

{

  GtkRecentManager *manager;

  GtkRecentInfo *retval;

  gchar *uri;

  g_return_val_if_fail (GTK_IS_RECENT_CHOOSER (chooser), NULL);

  uri = gtk_recent_chooser_get_current_uri (chooser);

  if (!uri)

    return NULL;

  manager = _gtk_recent_chooser_get_recent_manager (chooser);

  retval = gtk_recent_manager_lookup_item (manager, uri, NULL);

  g_free (uri);

  return retval;

}

/**

 * gtk_recent_chooser_select_uri:

 * @chooser: a #GtkRecentChooser

 * @uri: a URI

 * @error: (allow-none): return location for a #GError, or %NULL

 *

 * Selects @uri inside @chooser.

 *

 * Return value: %TRUE if @uri was found.

 *

 * Since: 2.10

 */

gboolean

gtk_recent_chooser_select_uri (GtkRecentChooser  *chooser,

			       const gchar       *uri,

			       GError           **error)

{

  g_return_val_if_fail (GTK_IS_RECENT_CHOOSER (chooser), FALSE);

  return GTK_RECENT_CHOOSER_GET_IFACE (chooser)->select_uri (chooser, uri, error);

}

/**

 * gtk_recent_chooser_unselect_uri:

 * @chooser: a #GtkRecentChooser

 * @uri: a URI

 *

 * Unselects @uri inside @chooser.

 *

 * Since: 2.10

 */

void

gtk_recent_chooser_unselect_uri (GtkRecentChooser *chooser,

				 const gchar      *uri)

{

  g_return_if_fail (GTK_IS_RECENT_CHOOSER (chooser));

  GTK_RECENT_CHOOSER_GET_IFACE (chooser)->unselect_uri (chooser, uri);

}

/**

 * gtk_recent_chooser_select_all:

 * @chooser: a #GtkRecentChooser

 *

 * Selects all the items inside @chooser, if the @chooser supports

 * multiple selection.

 *

 * Since: 2.10

 */

void

gtk_recent_chooser_select_all (GtkRecentChooser *chooser)

{

  g_return_if_fail (GTK_IS_RECENT_CHOOSER (chooser));

  GTK_RECENT_CHOOSER_GET_IFACE (chooser)->select_all (chooser);

}

/**

 * gtk_recent_chooser_unselect_all:

 * @chooser: a #GtkRecentChooser

 *

 * Unselects all the items inside @chooser.