258 lines
9.8 KiB
C
258 lines
9.8 KiB
C
|
/* GTK - The GIMP Toolkit
|
||
|
|
* gtkrecentmanager.h: a manager for the recently used resources
|
||
|
|
*
|
||
|
|
* Copyright (C) 2006 Emmanuele Bassi
|
||
|
|
*
|
||
|
|
* 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/>.
|
||
|
|
*/
|
||
|
|
|
||
|
|
#pragma once
|
||
|
|
|
||
|
|
#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
|
||
|
|
#error "Only <gtk/gtk.h> can be included directly."
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#include <gdk-pixbuf/gdk-pixbuf.h>
|
||
|
|
#include <gdk/gdk.h>
|
||
|
|
#include <time.h>
|
||
|
|
|
||
|
|
G_BEGIN_DECLS
|
||
|
|
|
||
|
|
#define GTK_TYPE_RECENT_INFO (gtk_recent_info_get_type ())
|
||
|
|
|
||
|
|
#define GTK_TYPE_RECENT_MANAGER (gtk_recent_manager_get_type ())
|
||
|
|
#define GTK_RECENT_MANAGER(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_RECENT_MANAGER, GtkRecentManager))
|
||
|
|
#define GTK_IS_RECENT_MANAGER(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_RECENT_MANAGER))
|
||
|
|
#define GTK_RECENT_MANAGER_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_RECENT_MANAGER, GtkRecentManagerClass))
|
||
|
|
#define GTK_IS_RECENT_MANAGER_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_RECENT_MANAGER))
|
||
|
|
#define GTK_RECENT_MANAGER_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_RECENT_MANAGER, GtkRecentManagerClass))
|
||
|
|
|
||
|
|
typedef struct _GtkRecentInfo GtkRecentInfo;
|
||
|
|
typedef struct _GtkRecentData GtkRecentData;
|
||
|
|
typedef struct _GtkRecentManager GtkRecentManager;
|
||
|
|
typedef struct _GtkRecentManagerClass GtkRecentManagerClass;
|
||
|
|
typedef struct _GtkRecentManagerPrivate GtkRecentManagerPrivate;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* GtkRecentData:
|
||
|
|
* @display_name: a UTF-8 encoded string, containing the name of the recently
|
||
|
|
* used resource to be displayed, or %NULL;
|
||
|
|
* @description: a UTF-8 encoded string, containing a short description of
|
||
|
|
* the resource, or %NULL;
|
||
|
|
* @mime_type: the MIME type of the resource;
|
||
|
|
* @app_name: the name of the application that is registering this recently
|
||
|
|
* used resource;
|
||
|
|
* @app_exec: command line used to launch this resource; may contain the
|
||
|
|
* “\%f” and “\%u” escape characters which will be expanded
|
||
|
|
* to the resource file path and URI respectively when the command line
|
||
|
|
* is retrieved;
|
||
|
|
* @groups: (array zero-terminated=1): a vector of strings containing
|
||
|
|
* groups names;
|
||
|
|
* @is_private: whether this resource should be displayed only by the
|
||
|
|
* applications that have registered it or not.
|
||
|
|
*
|
||
|
|
* Meta-data to be passed to gtk_recent_manager_add_full() when
|
||
|
|
* registering a recently used resource.
|
||
|
|
**/
|
||
|
|
struct _GtkRecentData
|
||
|
|
{
|
||
|
|
char *display_name;
|
||
|
|
char *description;
|
||
|
|
|
||
|
|
char *mime_type;
|
||
|
|
|
||
|
|
char *app_name;
|
||
|
|
char *app_exec;
|
||
|
|
|
||
|
|
char **groups;
|
||
|
|
|
||
|
|
gboolean is_private;
|
||
|
|
};
|
||
|
|
|
||
|
|
struct _GtkRecentManager
|
||
|
|
{
|
||
|
|
/*< private >*/
|
||
|
|
GObject parent_instance;
|
||
|
|
|
||
|
|
GtkRecentManagerPrivate *priv;
|
||
|
|
};
|
||
|
|
|
||
|
|
/**
|
||
|
|
* GtkRecentManagerClass:
|
||
|
|
*
|
||
|
|
* `GtkRecentManagerClass` contains only private data.
|
||
|
|
*/
|
||
|
|
struct _GtkRecentManagerClass
|
||
|
|
{
|
||
|
|
/*< private >*/
|
||
|
|
GObjectClass parent_class;
|
||
|
|
|
||
|
|
void (*changed) (GtkRecentManager *manager);
|
||
|
|
|
||
|
|
/* padding for future expansion */
|
||
|
|
void (*_gtk_recent1) (void);
|
||
|
|
void (*_gtk_recent2) (void);
|
||
|
|
void (*_gtk_recent3) (void);
|
||
|
|
void (*_gtk_recent4) (void);
|
||
|
|
};
|
||
|
|
|
||
|
|
/**
|
||
|
|
* GtkRecentManagerError:
|
||
|
|
* @GTK_RECENT_MANAGER_ERROR_NOT_FOUND: the URI specified does not exists in
|
||
|
|
* the recently used resources list.
|
||
|
|
* @GTK_RECENT_MANAGER_ERROR_INVALID_URI: the URI specified is not valid.
|
||
|
|
* @GTK_RECENT_MANAGER_ERROR_INVALID_ENCODING: the supplied string is not
|
||
|
|
* UTF-8 encoded.
|
||
|
|
* @GTK_RECENT_MANAGER_ERROR_NOT_REGISTERED: no application has registered
|
||
|
|
* the specified item.
|
||
|
|
* @GTK_RECENT_MANAGER_ERROR_READ: failure while reading the recently used
|
||
|
|
* resources file.
|
||
|
|
* @GTK_RECENT_MANAGER_ERROR_WRITE: failure while writing the recently used
|
||
|
|
* resources file.
|
||
|
|
* @GTK_RECENT_MANAGER_ERROR_UNKNOWN: unspecified error.
|
||
|
|
*
|
||
|
|
* Error codes for `GtkRecentManager` operations
|
||
|
|
*/
|
||
|
|
typedef enum
|
||
|
|
{
|
||
|
|
GTK_RECENT_MANAGER_ERROR_NOT_FOUND,
|
||
|
|
GTK_RECENT_MANAGER_ERROR_INVALID_URI,
|
||
|
|
GTK_RECENT_MANAGER_ERROR_INVALID_ENCODING,
|
||
|
|
GTK_RECENT_MANAGER_ERROR_NOT_REGISTERED,
|
||
|
|
GTK_RECENT_MANAGER_ERROR_READ,
|
||
|
|
GTK_RECENT_MANAGER_ERROR_WRITE,
|
||
|
|
GTK_RECENT_MANAGER_ERROR_UNKNOWN
|
||
|
|
} GtkRecentManagerError;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* GTK_RECENT_MANAGER_ERROR:
|
||
|
|
*
|
||
|
|
* The `GError` domain for `GtkRecentManager` errors.
|
||
|
|
*/
|
||
|
|
#define GTK_RECENT_MANAGER_ERROR (gtk_recent_manager_error_quark ())
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
GQuark gtk_recent_manager_error_quark (void);
|
||
|
|
|
||
|
|
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
GType gtk_recent_manager_get_type (void) G_GNUC_CONST;
|
||
|
|
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
GtkRecentManager *gtk_recent_manager_new (void);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
GtkRecentManager *gtk_recent_manager_get_default (void);
|
||
|
|
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
gboolean gtk_recent_manager_add_item (GtkRecentManager *manager,
|
||
|
|
const char *uri);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
gboolean gtk_recent_manager_add_full (GtkRecentManager *manager,
|
||
|
|
const char *uri,
|
||
|
|
const GtkRecentData *recent_data);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
gboolean gtk_recent_manager_remove_item (GtkRecentManager *manager,
|
||
|
|
const char *uri,
|
||
|
|
GError **error);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
GtkRecentInfo * gtk_recent_manager_lookup_item (GtkRecentManager *manager,
|
||
|
|
const char *uri,
|
||
|
|
GError **error);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
gboolean gtk_recent_manager_has_item (GtkRecentManager *manager,
|
||
|
|
const char *uri);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
gboolean gtk_recent_manager_move_item (GtkRecentManager *manager,
|
||
|
|
const char *uri,
|
||
|
|
const char *new_uri,
|
||
|
|
GError **error);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
GList * gtk_recent_manager_get_items (GtkRecentManager *manager);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
int gtk_recent_manager_purge_items (GtkRecentManager *manager,
|
||
|
|
GError **error);
|
||
|
|
|
||
|
|
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
GType gtk_recent_info_get_type (void) G_GNUC_CONST;
|
||
|
|
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
GtkRecentInfo * gtk_recent_info_ref (GtkRecentInfo *info);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
void gtk_recent_info_unref (GtkRecentInfo *info);
|
||
|
|
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
const char * gtk_recent_info_get_uri (GtkRecentInfo *info);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
const char * gtk_recent_info_get_display_name (GtkRecentInfo *info);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
const char * gtk_recent_info_get_description (GtkRecentInfo *info);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
const char * gtk_recent_info_get_mime_type (GtkRecentInfo *info);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
GDateTime * gtk_recent_info_get_added (GtkRecentInfo *info);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
GDateTime * gtk_recent_info_get_modified (GtkRecentInfo *info);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
GDateTime * gtk_recent_info_get_visited (GtkRecentInfo *info);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
gboolean gtk_recent_info_get_private_hint (GtkRecentInfo *info);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
gboolean gtk_recent_info_get_application_info (GtkRecentInfo *info,
|
||
|
|
const char *app_name,
|
||
|
|
const char **app_exec,
|
||
|
|
guint *count,
|
||
|
|
GDateTime **stamp);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
GAppInfo * gtk_recent_info_create_app_info (GtkRecentInfo *info,
|
||
|
|
const char *app_name,
|
||
|
|
GError **error);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
char ** gtk_recent_info_get_applications (GtkRecentInfo *info,
|
||
|
|
gsize *length) G_GNUC_MALLOC;
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
char * gtk_recent_info_last_application (GtkRecentInfo *info) G_GNUC_MALLOC;
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
gboolean gtk_recent_info_has_application (GtkRecentInfo *info,
|
||
|
|
const char *app_name);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
char ** gtk_recent_info_get_groups (GtkRecentInfo *info,
|
||
|
|
gsize *length) G_GNUC_MALLOC;
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
gboolean gtk_recent_info_has_group (GtkRecentInfo *info,
|
||
|
|
const char *group_name);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
GIcon * gtk_recent_info_get_gicon (GtkRecentInfo *info);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
char * gtk_recent_info_get_short_name (GtkRecentInfo *info) G_GNUC_MALLOC;
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
char * gtk_recent_info_get_uri_display (GtkRecentInfo *info) G_GNUC_MALLOC;
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
int gtk_recent_info_get_age (GtkRecentInfo *info);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
gboolean gtk_recent_info_is_local (GtkRecentInfo *info);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
gboolean gtk_recent_info_exists (GtkRecentInfo *info);
|
||
|
|
GDK_AVAILABLE_IN_ALL
|
||
|
|
gboolean gtk_recent_info_match (GtkRecentInfo *info_a,
|
||
|
|
GtkRecentInfo *info_b);
|
||
|
|
|
||
|
|
/* private */
|
||
|
|
void _gtk_recent_manager_sync (void);
|
||
|
|
|
||
|
|
G_DEFINE_AUTOPTR_CLEANUP_FUNC(GtkRecentManager, g_object_unref)
|
||
|
|
G_DEFINE_AUTOPTR_CLEANUP_FUNC(GtkRecentInfo, gtk_recent_info_unref)
|
||
|
|
|
||
|
|
G_END_DECLS
|
||
|
|
|