← Back to branch summary

~inkscape.dev/inkscape-devlibs/devlibs-gtk3

« back to all changes in this revision

Viewing changes to share/gtk-doc/html/gtk2/GtkRecentManager.html

  • Committer: JazzyNico
  • Date: 2013-01-21 10:11:05 UTC
  • Revision ID: nicoduf@yahoo.fr-20130121101105-i8d8slkq9ng4olx8
Adding gtk2 libraries.

Show diffs side-by-side

added added

removed removed

Lines of Context:
share/gtk-doc/html/gtk2/GtkRecentManager.html
 
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 
2
<html>
 
3
<head>
 
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 
5
<title>GtkRecentManager</title>
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
 
7
<link rel="home" href="index.html" title="GTK+ 2 Reference Manual">
 
8
<link rel="up" href="RecentDocuments.html" title="Recently Used Documents">
 
9
<link rel="prev" href="RecentDocuments.html" title="Recently Used Documents">
 
10
<link rel="next" href="GtkRecentChooser.html" title="GtkRecentChooser">
 
11
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
 
12
<link rel="stylesheet" href="style.css" type="text/css">
 
13
</head>
 
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
 
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
 
16
<tr valign="middle">
 
17
<td><a accesskey="p" href="RecentDocuments.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
 
18
<td><a accesskey="u" href="RecentDocuments.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
 
19
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
 
20
<th width="100%" align="center">GTK+ 2 Reference Manual</th>
 
21
<td><a accesskey="n" href="GtkRecentChooser.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
 
22
</tr>
 
23
<tr><td colspan="5" class="shortcuts">
 
24
<a href="#GtkRecentManager.synopsis" class="shortcut">Top</a>
 
25
                   | 
 
26
                  <a href="#GtkRecentManager.description" class="shortcut">Description</a>
 
27
                   | 
 
28
                  <a href="#GtkRecentManager.object-hierarchy" class="shortcut">Object Hierarchy</a>
 
29
                   | 
 
30
                  <a href="#GtkRecentManager.properties" class="shortcut">Properties</a>
 
31
                   | 
 
32
                  <a href="#GtkRecentManager.signals" class="shortcut">Signals</a>
 
33
</td></tr>
 
34
</table>
 
35
<div class="refentry">
 
36
<a name="GtkRecentManager"></a><div class="titlepage"></div>
 
37
<div class="refnamediv"><table width="100%"><tr>
 
38
<td valign="top">
 
39
<h2><span class="refentrytitle"><a name="GtkRecentManager.top_of_page"></a>GtkRecentManager</span></h2>
 
40
<p>GtkRecentManager — Managing Recently Used Files</p>
 
41
</td>
 
42
<td valign="top" align="right"></td>
 
43
</tr></table></div>
 
44
<div class="refsynopsisdiv">
 
45
<a name="GtkRecentManager.synopsis"></a><h2>Synopsis</h2>
 
46
<pre class="synopsis">
 
47
#include &lt;gtk/gtk.h&gt;
 
48
 
 
49
struct              <a class="link" href="GtkRecentManager.html#GtkRecentManager-struct" title="struct GtkRecentManager">GtkRecentManager</a>;
 
50
                    <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo">GtkRecentInfo</a>;
 
51
struct              <a class="link" href="GtkRecentManager.html#GtkRecentData" title="struct GtkRecentData">GtkRecentData</a>;
 
52
#define             <a class="link" href="GtkRecentManager.html#GTK-RECENT-MANAGER-ERROR:CAPS" title="GTK_RECENT_MANAGER_ERROR">GTK_RECENT_MANAGER_ERROR</a>
 
53
enum                <a class="link" href="GtkRecentManager.html#GtkRecentManagerError" title="enum GtkRecentManagerError">GtkRecentManagerError</a>;
 
54
<a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="returnvalue">GtkRecentManager</span></a> *  <a class="link" href="GtkRecentManager.html#gtk-recent-manager-new" title="gtk_recent_manager_new ()">gtk_recent_manager_new</a>              (<em class="parameter"><code><span class="type">void</span></code></em>);
 
55
<a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="returnvalue">GtkRecentManager</span></a> *  <a class="link" href="GtkRecentManager.html#gtk-recent-manager-get-default" title="gtk_recent_manager_get_default ()">gtk_recent_manager_get_default</a>      (<em class="parameter"><code><span class="type">void</span></code></em>);
 
56
<a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="returnvalue">GtkRecentManager</span></a> *  <a class="link" href="GtkRecentManager.html#gtk-recent-manager-get-for-screen" title="gtk_recent_manager_get_for_screen ()">gtk_recent_manager_get_for_screen</a>   (<em class="parameter"><code><a href="../gdk2/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);
 
57
<span class="returnvalue">void</span>                <a class="link" href="GtkRecentManager.html#gtk-recent-manager-set-screen" title="gtk_recent_manager_set_screen ()">gtk_recent_manager_set_screen</a>       (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
 
58
                                                         <em class="parameter"><code><a href="../gdk2/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);
 
59
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkRecentManager.html#gtk-recent-manager-add-item" title="gtk_recent_manager_add_item ()">gtk_recent_manager_add_item</a>         (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
 
60
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *uri</code></em>);
 
61
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkRecentManager.html#gtk-recent-manager-add-full" title="gtk_recent_manager_add_full ()">gtk_recent_manager_add_full</a>         (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
 
62
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *uri</code></em>,
 
63
                                                         <em class="parameter"><code>const <a class="link" href="GtkRecentManager.html#GtkRecentData" title="struct GtkRecentData"><span class="type">GtkRecentData</span></a> *recent_data</code></em>);
 
64
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkRecentManager.html#gtk-recent-manager-remove-item" title="gtk_recent_manager_remove_item ()">gtk_recent_manager_remove_item</a>      (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
 
65
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *uri</code></em>,
 
66
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
 
67
<a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="returnvalue">GtkRecentInfo</span></a> *     <a class="link" href="GtkRecentManager.html#gtk-recent-manager-lookup-item" title="gtk_recent_manager_lookup_item ()">gtk_recent_manager_lookup_item</a>      (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
 
68
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *uri</code></em>,
 
69
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
 
70
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkRecentManager.html#gtk-recent-manager-has-item" title="gtk_recent_manager_has_item ()">gtk_recent_manager_has_item</a>         (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
 
71
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *uri</code></em>);
 
72
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkRecentManager.html#gtk-recent-manager-move-item" title="gtk_recent_manager_move_item ()">gtk_recent_manager_move_item</a>        (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
 
73
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *uri</code></em>,
 
74
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *new_uri</code></em>,
 
75
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
 
76
<span class="returnvalue">gint</span>                <a class="link" href="GtkRecentManager.html#gtk-recent-manager-get-limit" title="gtk_recent_manager_get_limit ()">gtk_recent_manager_get_limit</a>        (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>);
 
77
<span class="returnvalue">void</span>                <a class="link" href="GtkRecentManager.html#gtk-recent-manager-set-limit" title="gtk_recent_manager_set_limit ()">gtk_recent_manager_set_limit</a>        (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
 
78
                                                         <em class="parameter"><code><span class="type">gint</span> limit</code></em>);
 
79
<span class="returnvalue">GList</span> *             <a class="link" href="GtkRecentManager.html#gtk-recent-manager-get-items" title="gtk_recent_manager_get_items ()">gtk_recent_manager_get_items</a>        (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>);
 
80
<span class="returnvalue">gint</span>                <a class="link" href="GtkRecentManager.html#gtk-recent-manager-purge-items" title="gtk_recent_manager_purge_items ()">gtk_recent_manager_purge_items</a>      (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
 
81
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
 
82
 
 
83
<a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="returnvalue">GtkRecentInfo</span></a> *     <a class="link" href="GtkRecentManager.html#gtk-recent-info-ref" title="gtk_recent_info_ref ()">gtk_recent_info_ref</a>                 (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);
 
84
<span class="returnvalue">void</span>                <a class="link" href="GtkRecentManager.html#gtk-recent-info-unref" title="gtk_recent_info_unref ()">gtk_recent_info_unref</a>               (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);
 
85
const <span class="returnvalue">gchar</span> *       <a class="link" href="GtkRecentManager.html#gtk-recent-info-get-uri" title="gtk_recent_info_get_uri ()">gtk_recent_info_get_uri</a>             (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);
 
86
const <span class="returnvalue">gchar</span> *       <a class="link" href="GtkRecentManager.html#gtk-recent-info-get-display-name" title="gtk_recent_info_get_display_name ()">gtk_recent_info_get_display_name</a>    (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);
 
87
const <span class="returnvalue">gchar</span> *       <a class="link" href="GtkRecentManager.html#gtk-recent-info-get-description" title="gtk_recent_info_get_description ()">gtk_recent_info_get_description</a>     (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);
 
88
const <span class="returnvalue">gchar</span> *       <a class="link" href="GtkRecentManager.html#gtk-recent-info-get-mime-type" title="gtk_recent_info_get_mime_type ()">gtk_recent_info_get_mime_type</a>       (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);
 
89
<span class="returnvalue">time_t</span>              <a class="link" href="GtkRecentManager.html#gtk-recent-info-get-added" title="gtk_recent_info_get_added ()">gtk_recent_info_get_added</a>           (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);
 
90
<span class="returnvalue">time_t</span>              <a class="link" href="GtkRecentManager.html#gtk-recent-info-get-modified" title="gtk_recent_info_get_modified ()">gtk_recent_info_get_modified</a>        (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);
 
91
<span class="returnvalue">time_t</span>              <a class="link" href="GtkRecentManager.html#gtk-recent-info-get-visited" title="gtk_recent_info_get_visited ()">gtk_recent_info_get_visited</a>         (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);
 
92
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkRecentManager.html#gtk-recent-info-get-private-hint" title="gtk_recent_info_get_private_hint ()">gtk_recent_info_get_private_hint</a>    (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);
 
93
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkRecentManager.html#gtk-recent-info-get-application-info" title="gtk_recent_info_get_application_info ()">gtk_recent_info_get_application_info</a>
 
94
                                                        (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>,
 
95
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *app_name</code></em>,
 
96
                                                         <em class="parameter"><code>const <span class="type">gchar</span> **app_exec</code></em>,
 
97
                                                         <em class="parameter"><code><span class="type">guint</span> *count</code></em>,
 
98
                                                         <em class="parameter"><code><span class="type">time_t</span> *time_</code></em>);
 
99
<span class="returnvalue">gchar</span> **            <a class="link" href="GtkRecentManager.html#gtk-recent-info-get-applications" title="gtk_recent_info_get_applications ()">gtk_recent_info_get_applications</a>    (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>,
 
100
                                                         <em class="parameter"><code><span class="type">gsize</span> *length</code></em>);
 
101
<span class="returnvalue">gchar</span> *             <a class="link" href="GtkRecentManager.html#gtk-recent-info-last-application" title="gtk_recent_info_last_application ()">gtk_recent_info_last_application</a>    (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);
 
102
<span class="returnvalue">gchar</span> **            <a class="link" href="GtkRecentManager.html#gtk-recent-info-get-groups" title="gtk_recent_info_get_groups ()">gtk_recent_info_get_groups</a>          (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>,
 
103
                                                         <em class="parameter"><code><span class="type">gsize</span> *length</code></em>);
 
104
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkRecentManager.html#gtk-recent-info-has-group" title="gtk_recent_info_has_group ()">gtk_recent_info_has_group</a>           (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>,
 
105
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *group_name</code></em>);
 
106
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkRecentManager.html#gtk-recent-info-has-application" title="gtk_recent_info_has_application ()">gtk_recent_info_has_application</a>     (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>,
 
107
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *app_name</code></em>);
 
108
<a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *         <a class="link" href="GtkRecentManager.html#gtk-recent-info-get-icon" title="gtk_recent_info_get_icon ()">gtk_recent_info_get_icon</a>            (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>,
 
109
                                                         <em class="parameter"><code><span class="type">gint</span> size</code></em>);
 
110
<span class="returnvalue">gchar</span> *             <a class="link" href="GtkRecentManager.html#gtk-recent-info-get-short-name" title="gtk_recent_info_get_short_name ()">gtk_recent_info_get_short_name</a>      (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);
 
111
<span class="returnvalue">gchar</span> *             <a class="link" href="GtkRecentManager.html#gtk-recent-info-get-uri-display" title="gtk_recent_info_get_uri_display ()">gtk_recent_info_get_uri_display</a>     (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);
 
112
<span class="returnvalue">gint</span>                <a class="link" href="GtkRecentManager.html#gtk-recent-info-get-age" title="gtk_recent_info_get_age ()">gtk_recent_info_get_age</a>             (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);
 
113
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkRecentManager.html#gtk-recent-info-is-local" title="gtk_recent_info_is_local ()">gtk_recent_info_is_local</a>            (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);
 
114
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkRecentManager.html#gtk-recent-info-exists" title="gtk_recent_info_exists ()">gtk_recent_info_exists</a>              (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);
 
115
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkRecentManager.html#gtk-recent-info-match" title="gtk_recent_info_match ()">gtk_recent_info_match</a>               (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info_a</code></em>,
 
116
                                                         <em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info_b</code></em>);
 
117
</pre>
 
118
</div>
 
119
<div class="refsect1">
 
120
<a name="GtkRecentManager.object-hierarchy"></a><h2>Object Hierarchy</h2>
 
121
<pre class="synopsis">
 
122
  GObject
 
123
   +----GtkRecentManager
 
124
</pre>
 
125
</div>
 
126
<div class="refsect1">
 
127
<a name="GtkRecentManager.properties"></a><h2>Properties</h2>
 
128
<pre class="synopsis">
 
129
  "<a class="link" href="GtkRecentManager.html#GtkRecentManager--filename" title='The "filename" property'>filename</a>"                 <span class="type">gchar</span>*                : Read / Write / Construct Only
 
130
  "<a class="link" href="GtkRecentManager.html#GtkRecentManager--limit" title='The "limit" property'>limit</a>"                    <span class="type">gint</span>                  : Read / Write
 
131
  "<a class="link" href="GtkRecentManager.html#GtkRecentManager--size" title='The "size" property'>size</a>"                     <span class="type">gint</span>                  : Read
 
132
</pre>
 
133
</div>
 
134
<div class="refsect1">
 
135
<a name="GtkRecentManager.signals"></a><h2>Signals</h2>
 
136
<pre class="synopsis">
 
137
  "<a class="link" href="GtkRecentManager.html#GtkRecentManager-changed" title='The "changed" signal'>changed</a>"                                        : <code class="literal">Run First</code>
 
138
</pre>
 
139
</div>
 
140
<div class="refsect1">
 
141
<a name="GtkRecentManager.description"></a><h2>Description</h2>
 
142
<p>
 
143
<a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> provides a facility for adding, removing and
 
144
looking up recently used files.  Each recently used file is
 
145
identified by its URI, and has meta-data associated to it, like
 
146
the names and command lines of the applications that have
 
147
registered it, the number of time each application has registered
 
148
the same file, the mime type of the file and whether the file
 
149
should be displayed only by the applications that have
 
150
registered it.
 
151
</p>
 
152
<p>
 
153
The <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> acts like a database of all the recently
 
154
used files.  You can create new <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> objects, but
 
155
it is more efficient to use the standard recent manager for
 
156
the <a href="../gdk2/GdkScreen.html"><span class="type">GdkScreen</span></a> so that informations about the recently used
 
157
files is shared with other people using them.  In case the
 
158
default screen is being used, adding a new recently used
 
159
file is as simple as:
 
160
</p>
 
161
<div class="informalexample">
 
162
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 
163
    <tbody>
 
164
      <tr>
 
165
        <td class="listing_lines" align="right"><pre>1
 
166
2
 
167
3</pre></td>
 
168
        <td class="listing_code"><pre class="programlisting"><span class="usertype">GtkRecentManager</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">manager</span><span class="symbol">;</span>
 
169
<span class="normal">manager </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkRecentManager.html#gtk-recent-manager-get-default">gtk_recent_manager_get_default</a></span><span class="normal"> </span><span class="symbol">();</span>
 
170
<span class="function"><a href="GtkRecentManager.html#gtk-recent-manager-add-item">gtk_recent_manager_add_item</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">manager</span><span class="symbol">,</span><span class="normal"> file_uri</span><span class="symbol">);</span></pre></td>
 
171
      </tr>
 
172
    </tbody>
 
173
  </table>
 
174
</div>
 
175
 
 
176
While looking up a recently used file is as simple as:
 
177
<div class="informalexample">
 
178
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
 
179
    <tbody>
 
180
      <tr>
 
181
        <td class="listing_lines" align="right"><pre>1
 
182
2
 
183
3
 
184
4
 
185
5
 
186
6
 
187
7
 
188
8
 
189
9
 
190
10
 
191
11
 
192
12
 
193
13
 
194
14
 
195
15</pre></td>
 
196
        <td class="listing_code"><pre class="programlisting"><span class="usertype">GtkRecentManager</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">manager</span><span class="symbol">;</span>
 
197
<span class="usertype">GtkRecentInfo</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">info</span><span class="symbol">;</span>
 
198
<span class="usertype">GError</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">error </span><span class="symbol">=</span><span class="normal"> <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
 
199
<span class="normal">manager </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkRecentManager.html#gtk-recent-manager-get-default">gtk_recent_manager_get_default</a></span><span class="normal"> </span><span class="symbol">();</span>
 
200
<span class="normal">info </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkRecentManager.html#gtk-recent-manager-lookup-item">gtk_recent_manager_lookup_item</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">manager</span><span class="symbol">,</span><span class="normal"> file_uri</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">error</span><span class="symbol">);</span>
 
201
<span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error</span><span class="symbol">)</span>
 
202
<span class="normal">  </span><span class="cbracket">{</span>
 
203
<span class="normal">    </span><span class="function">g_warning</span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Could not find the file: %s"</span><span class="symbol">,</span><span class="normal"> error</span><span class="symbol">-&gt;</span><span class="normal">message</span><span class="symbol">);</span>
 
204
<span class="normal">    </span><span class="function">g_error_free</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error</span><span class="symbol">);</span>
 
205
<span class="normal">  </span><span class="cbracket">}</span>
 
206
<span class="keyword">else</span>
 
207
<span class="normal">  </span><span class="cbracket">{</span>
 
208
<span class="normal">    </span><span class="comment">/* Use the info object */</span>
 
209
<span class="normal">    </span><span class="function"><a href="GtkRecentManager.html#gtk-recent-info-unref">gtk_recent_info_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">info</span><span class="symbol">);</span>
 
210
<span class="normal">  </span><span class="cbracket">}</span></pre></td>
 
211
      </tr>
 
212
    </tbody>
 
213
  </table>
 
214
</div>
 
215
 
 
216
<p>
 
217
Recently used files are supported since GTK+ 2.10.
 
218
</p>
 
219
</div>
 
220
<div class="refsect1">
 
221
<a name="GtkRecentManager.details"></a><h2>Details</h2>
 
222
<div class="refsect2">
 
223
<a name="GtkRecentManager-struct"></a><h3>struct GtkRecentManager</h3>
 
224
<pre class="programlisting">struct GtkRecentManager;</pre>
 
225
<p>
 
226
Acts as a database of information about the list of recently
 
227
used files.  Normally, you retrieve the recent manager for a
 
228
particular screen using <a class="link" href="GtkRecentManager.html#gtk-recent-manager-get-for-screen" title="gtk_recent_manager_get_for_screen ()"><code class="function">gtk_recent_manager_get_for_screen()</code></a>
 
229
and it will contain information about current recent manager
 
230
for that screen.</p>
 
231
</div>
 
232
<hr>
 
233
<div class="refsect2">
 
234
<a name="GtkRecentInfo"></a><h3>GtkRecentInfo</h3>
 
235
<pre class="programlisting">typedef struct _GtkRecentInfo GtkRecentInfo;</pre>
 
236
<p>
 
237
Contains informations found when looking up an entry of the
 
238
recently used files list.
 
239
</p>
 
240
</div>
 
241
<hr>
 
242
<div class="refsect2">
 
243
<a name="GtkRecentData"></a><h3>struct GtkRecentData</h3>
 
244
<pre class="programlisting">struct GtkRecentData {
 
245
  gchar *display_name;
 
246
  gchar *description;
 
247
 
 
248
  gchar *mime_type;
 
249
 
 
250
  gchar *app_name;
 
251
  gchar *app_exec;
 
252
 
 
253
  gchar **groups;
 
254
 
 
255
  gboolean is_private;
 
256
};
 
257
</pre>
 
258
<p>
 
259
Meta-data to be passed to <a class="link" href="GtkRecentManager.html#gtk-recent-manager-add-full" title="gtk_recent_manager_add_full ()"><code class="function">gtk_recent_manager_add_full()</code></a> when
 
260
registering a recently used resource.
 
261
</p>
 
262
<div class="variablelist"><table border="0" class="variablelist">
 
263
<colgroup>
 
264
<col align="left" valign="top">
 
265
<col>
 
266
</colgroup>
 
267
<tbody>
 
268
<tr>
 
269
<td><p><span class="term"><span class="type">gchar</span> *<em class="structfield"><code><a name="GtkRecentData.display-name"></a>display_name</code></em>;</span></p></td>
 
270
<td>a UTF-8 encoded string, containing the name of the recently
 
271
used resource to be displayed, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>;</td>
 
272
</tr>
 
273
<tr>
 
274
<td><p><span class="term"><span class="type">gchar</span> *<em class="structfield"><code><a name="GtkRecentData.description"></a>description</code></em>;</span></p></td>
 
275
<td>a UTF-8 encoded string, containing a short description of
 
276
the resource, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>;</td>
 
277
</tr>
 
278
<tr>
 
279
<td><p><span class="term"><span class="type">gchar</span> *<em class="structfield"><code><a name="GtkRecentData.mime-type"></a>mime_type</code></em>;</span></p></td>
 
280
<td>the MIME type of the resource;</td>
 
281
</tr>
 
282
<tr>
 
283
<td><p><span class="term"><span class="type">gchar</span> *<em class="structfield"><code><a name="GtkRecentData.app-name"></a>app_name</code></em>;</span></p></td>
 
284
<td>the name of the application that is registering this recently
 
285
used resource;</td>
 
286
</tr>
 
287
<tr>
 
288
<td><p><span class="term"><span class="type">gchar</span> *<em class="structfield"><code><a name="GtkRecentData.app-exec"></a>app_exec</code></em>;</span></p></td>
 
289
<td>command line used to launch this resource; may contain the
 
290
"%f" and "%u" escape characters which will be expanded
 
291
to the resource file path and URI respectively when the command line
 
292
is retrieved;</td>
 
293
</tr>
 
294
<tr>
 
295
<td><p><span class="term"><span class="type">gchar</span> **<em class="structfield"><code><a name="GtkRecentData.groups"></a>groups</code></em>;</span></p></td>
 
296
<td>a vector of strings containing groups names;</td>
 
297
</tr>
 
298
<tr>
 
299
<td><p><span class="term"><span class="type">gboolean</span> <em class="structfield"><code><a name="GtkRecentData.is-private"></a>is_private</code></em>;</span></p></td>
 
300
<td>whether this resource should be displayed only by the
 
301
applications that have registered it or not.</td>
 
302
</tr>
 
303
</tbody>
 
304
</table></div>
 
305
</div>
 
306
<hr>
 
307
<div class="refsect2">
 
308
<a name="GTK-RECENT-MANAGER-ERROR:CAPS"></a><h3>GTK_RECENT_MANAGER_ERROR</h3>
 
309
<pre class="programlisting">#define GTK_RECENT_MANAGER_ERROR (gtk_recent_manager_error_quark ())
 
310
</pre>
 
311
<p>
 
312
The <span class="type">GQuark</span> used for <a class="link" href="GtkRecentManager.html#GtkRecentManagerError" title="enum GtkRecentManagerError"><span class="type">GtkRecentManagerError</span></a> errors.
 
313
</p>
 
314
</div>
 
315
<hr>
 
316
<div class="refsect2">
 
317
<a name="GtkRecentManagerError"></a><h3>enum GtkRecentManagerError</h3>
 
318
<pre class="programlisting">typedef enum {
 
319
  GTK_RECENT_MANAGER_ERROR_NOT_FOUND,
 
320
  GTK_RECENT_MANAGER_ERROR_INVALID_URI,
 
321
  GTK_RECENT_MANAGER_ERROR_INVALID_ENCODING,
 
322
  GTK_RECENT_MANAGER_ERROR_NOT_REGISTERED,
 
323
  GTK_RECENT_MANAGER_ERROR_READ,
 
324
  GTK_RECENT_MANAGER_ERROR_WRITE,
 
325
  GTK_RECENT_MANAGER_ERROR_UNKNOWN
 
326
} GtkRecentManagerError;
 
327
</pre>
 
328
<p>
 
329
Error codes for GtkRecentManager operations
 
330
</p>
 
331
<div class="variablelist"><table border="0" class="variablelist">
 
332
<colgroup>
 
333
<col align="left" valign="top">
 
334
<col>
 
335
</colgroup>
 
336
<tbody>
 
337
<tr>
 
338
<td><p><a name="GTK-RECENT-MANAGER-ERROR-NOT-FOUND:CAPS"></a><span class="term"><code class="literal">GTK_RECENT_MANAGER_ERROR_NOT_FOUND</code></span></p></td>
 
339
<td>the URI specified does not exists in
 
340
  the recently used resources list.
 
341
</td>
 
342
</tr>
 
343
<tr>
 
344
<td><p><a name="GTK-RECENT-MANAGER-ERROR-INVALID-URI:CAPS"></a><span class="term"><code class="literal">GTK_RECENT_MANAGER_ERROR_INVALID_URI</code></span></p></td>
 
345
<td>the URI specified is not valid.
 
346
</td>
 
347
</tr>
 
348
<tr>
 
349
<td><p><a name="GTK-RECENT-MANAGER-ERROR-INVALID-ENCODING:CAPS"></a><span class="term"><code class="literal">GTK_RECENT_MANAGER_ERROR_INVALID_ENCODING</code></span></p></td>
 
350
<td>the supplied string is not
 
351
  UTF-8 encoded.
 
352
</td>
 
353
</tr>
 
354
<tr>
 
355
<td><p><a name="GTK-RECENT-MANAGER-ERROR-NOT-REGISTERED:CAPS"></a><span class="term"><code class="literal">GTK_RECENT_MANAGER_ERROR_NOT_REGISTERED</code></span></p></td>
 
356
<td>no application has registered
 
357
  the specified item.
 
358
</td>
 
359
</tr>
 
360
<tr>
 
361
<td><p><a name="GTK-RECENT-MANAGER-ERROR-READ:CAPS"></a><span class="term"><code class="literal">GTK_RECENT_MANAGER_ERROR_READ</code></span></p></td>
 
362
<td>failure while reading the recently used
 
363
  resources file.
 
364
</td>
 
365
</tr>
 
366
<tr>
 
367
<td><p><a name="GTK-RECENT-MANAGER-ERROR-WRITE:CAPS"></a><span class="term"><code class="literal">GTK_RECENT_MANAGER_ERROR_WRITE</code></span></p></td>
 
368
<td>failure while writing the recently used
 
369
  resources file.
 
370
</td>
 
371
</tr>
 
372
<tr>
 
373
<td><p><a name="GTK-RECENT-MANAGER-ERROR-UNKNOWN:CAPS"></a><span class="term"><code class="literal">GTK_RECENT_MANAGER_ERROR_UNKNOWN</code></span></p></td>
 
374
<td>unspecified error.
 
375
</td>
 
376
</tr>
 
377
</tbody>
 
378
</table></div>
 
379
</div>
 
380
<hr>
 
381
<div class="refsect2">
 
382
<a name="gtk-recent-manager-new"></a><h3>gtk_recent_manager_new ()</h3>
 
383
<pre class="programlisting"><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="returnvalue">GtkRecentManager</span></a> *  gtk_recent_manager_new              (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
384
<p>
 
385
Creates a new recent manager object.  Recent manager objects are used to
 
386
handle the list of recently used resources.  A <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> object
 
387
monitors the recently used resources list, and emits the "changed" signal
 
388
each time something inside the list changes.
 
389
</p>
 
390
<p>
 
391
<a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> objects are expensive: be sure to create them only when
 
392
needed. You should use <a class="link" href="GtkRecentManager.html#gtk-recent-manager-get-default" title="gtk_recent_manager_get_default ()"><code class="function">gtk_recent_manager_get_default()</code></a> instead.
 
393
</p>
 
394
<div class="variablelist"><table border="0" class="variablelist">
 
395
<colgroup>
 
396
<col align="left" valign="top">
 
397
<col>
 
398
</colgroup>
 
399
<tbody><tr>
 
400
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
401
<td>A newly created <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> object.</td>
 
402
</tr></tbody>
 
403
</table></div>
 
404
<p class="since">Since 2.10</p>
 
405
</div>
 
406
<hr>
 
407
<div class="refsect2">
 
408
<a name="gtk-recent-manager-get-default"></a><h3>gtk_recent_manager_get_default ()</h3>
 
409
<pre class="programlisting"><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="returnvalue">GtkRecentManager</span></a> *  gtk_recent_manager_get_default      (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
410
<p>
 
411
Gets a unique instance of <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>, that you can share
 
412
in your application without caring about memory management. The
 
413
returned instance will be freed when you application terminates.
 
414
</p>
 
415
<div class="variablelist"><table border="0" class="variablelist">
 
416
<colgroup>
 
417
<col align="left" valign="top">
 
418
<col>
 
419
</colgroup>
 
420
<tbody><tr>
 
421
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
422
<td>A unique <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>. Do not ref or unref it. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
423
</td>
 
424
</tr></tbody>
 
425
</table></div>
 
426
<p class="since">Since 2.10</p>
 
427
</div>
 
428
<hr>
 
429
<div class="refsect2">
 
430
<a name="gtk-recent-manager-get-for-screen"></a><h3>gtk_recent_manager_get_for_screen ()</h3>
 
431
<pre class="programlisting"><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="returnvalue">GtkRecentManager</span></a> *  gtk_recent_manager_get_for_screen   (<em class="parameter"><code><a href="../gdk2/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
 
432
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
433
<h3 class="title">Warning</h3>
 
434
<p><code class="literal">gtk_recent_manager_get_for_screen</code> has been deprecated since version 2.12 and should not be used in newly-written code. This function has been deprecated and should
 
435
  not be used in newly written code. Calling this function is
 
436
  equivalent to calling <a class="link" href="GtkRecentManager.html#gtk-recent-manager-get-default" title="gtk_recent_manager_get_default ()"><code class="function">gtk_recent_manager_get_default()</code></a>.</p>
 
437
</div>
 
438
<p>
 
439
Gets the recent manager object associated with <em class="parameter"><code>screen</code></em>; if this
 
440
function has not previously been called for the given screen,
 
441
a new recent manager object will be created and associated with
 
442
the screen. Recent manager objects are fairly expensive to create,
 
443
so using this function is usually a better choice than calling 
 
444
<a class="link" href="GtkRecentManager.html#gtk-recent-manager-new" title="gtk_recent_manager_new ()"><code class="function">gtk_recent_manager_new()</code></a> and setting the screen yourself; by using
 
445
this function a single recent manager object will be shared between
 
446
users.
 
447
</p>
 
448
<div class="variablelist"><table border="0" class="variablelist">
 
449
<colgroup>
 
450
<col align="left" valign="top">
 
451
<col>
 
452
</colgroup>
 
453
<tbody>
 
454
<tr>
 
455
<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
 
456
<td>a <a href="../gdk2/GdkScreen.html"><span class="type">GdkScreen</span></a>
 
457
</td>
 
458
</tr>
 
459
<tr>
 
460
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
461
<td>A unique <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> associated with the given
 
462
screen. This recent manager is associated to the with the screen
 
463
and can be used as long as the screen is open. Do not ref or
 
464
unref it.</td>
 
465
</tr>
 
466
</tbody>
 
467
</table></div>
 
468
<p class="since">Since 2.10</p>
 
469
</div>
 
470
<hr>
 
471
<div class="refsect2">
 
472
<a name="gtk-recent-manager-set-screen"></a><h3>gtk_recent_manager_set_screen ()</h3>
 
473
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_recent_manager_set_screen       (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
 
474
                                                         <em class="parameter"><code><a href="../gdk2/GdkScreen.html"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
 
475
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
476
<h3 class="title">Warning</h3>
 
477
<p><code class="literal">gtk_recent_manager_set_screen</code> has been deprecated since version 2.12 and should not be used in newly-written code. This function has been deprecated and should
 
478
  not be used in newly written code. Calling this function has
 
479
  no effect.</p>
 
480
</div>
 
481
<p>
 
482
Sets the screen for a recent manager; the screen is used to
 
483
track the user's currently configured recently used documents
 
484
storage.
 
485
</p>
 
486
<div class="variablelist"><table border="0" class="variablelist">
 
487
<colgroup>
 
488
<col align="left" valign="top">
 
489
<col>
 
490
</colgroup>
 
491
<tbody>
 
492
<tr>
 
493
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
 
494
<td>a <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>
 
495
</td>
 
496
</tr>
 
497
<tr>
 
498
<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
 
499
<td>a <a href="../gdk2/GdkScreen.html"><span class="type">GdkScreen</span></a>
 
500
</td>
 
501
</tr>
 
502
</tbody>
 
503
</table></div>
 
504
<p class="since">Since 2.10</p>
 
505
</div>
 
506
<hr>
 
507
<div class="refsect2">
 
508
<a name="gtk-recent-manager-add-item"></a><h3>gtk_recent_manager_add_item ()</h3>
 
509
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_recent_manager_add_item         (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
 
510
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *uri</code></em>);</pre>
 
511
<p>
 
512
Adds a new resource, pointed by <em class="parameter"><code>uri</code></em>, into the recently used
 
513
resources list.
 
514
</p>
 
515
<p>
 
516
This function automatically retrieves some of the needed
 
517
metadata and setting other metadata to common default values; it
 
518
then feeds the data to <a class="link" href="GtkRecentManager.html#gtk-recent-manager-add-full" title="gtk_recent_manager_add_full ()"><code class="function">gtk_recent_manager_add_full()</code></a>.
 
519
</p>
 
520
<p>
 
521
See <a class="link" href="GtkRecentManager.html#gtk-recent-manager-add-full" title="gtk_recent_manager_add_full ()"><code class="function">gtk_recent_manager_add_full()</code></a> if you want to explicitly
 
522
define the metadata for the resource pointed by <em class="parameter"><code>uri</code></em>.
 
523
</p>
 
524
<div class="variablelist"><table border="0" class="variablelist">
 
525
<colgroup>
 
526
<col align="left" valign="top">
 
527
<col>
 
528
</colgroup>
 
529
<tbody>
 
530
<tr>
 
531
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
 
532
<td>a <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>
 
533
</td>
 
534
</tr>
 
535
<tr>
 
536
<td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
 
537
<td>a valid URI</td>
 
538
</tr>
 
539
<tr>
 
540
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
541
<td>
 
542
<code class="literal">TRUE</code> if the new item was successfully added
 
543
to the recently used resources list</td>
 
544
</tr>
 
545
</tbody>
 
546
</table></div>
 
547
<p class="since">Since 2.10</p>
 
548
</div>
 
549
<hr>
 
550
<div class="refsect2">
 
551
<a name="gtk-recent-manager-add-full"></a><h3>gtk_recent_manager_add_full ()</h3>
 
552
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_recent_manager_add_full         (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
 
553
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *uri</code></em>,
 
554
                                                         <em class="parameter"><code>const <a class="link" href="GtkRecentManager.html#GtkRecentData" title="struct GtkRecentData"><span class="type">GtkRecentData</span></a> *recent_data</code></em>);</pre>
 
555
<p>
 
556
Adds a new resource, pointed by <em class="parameter"><code>uri</code></em>, into the recently used
 
557
resources list, using the metadata specified inside the <a class="link" href="GtkRecentManager.html#GtkRecentData" title="struct GtkRecentData"><span class="type">GtkRecentData</span></a>
 
558
structure passed in <em class="parameter"><code>recent_data</code></em>.
 
559
</p>
 
560
<p>
 
561
The passed URI will be used to identify this resource inside the
 
562
list.
 
563
</p>
 
564
<p>
 
565
In order to register the new recently used resource, metadata about
 
566
the resource must be passed as well as the URI; the metadata is
 
567
stored in a <a class="link" href="GtkRecentManager.html#GtkRecentData" title="struct GtkRecentData"><span class="type">GtkRecentData</span></a> structure, which must contain the MIME
 
568
type of the resource pointed by the URI; the name of the application
 
569
that is registering the item, and a command line to be used when
 
570
launching the item.
 
571
</p>
 
572
<p>
 
573
Optionally, a <a class="link" href="GtkRecentManager.html#GtkRecentData" title="struct GtkRecentData"><span class="type">GtkRecentData</span></a> structure might contain a UTF-8 string
 
574
to be used when viewing the item instead of the last component of the
 
575
URI; a short description of the item; whether the item should be
 
576
considered private - that is, should be displayed only by the
 
577
applications that have registered it.
 
578
</p>
 
579
<div class="variablelist"><table border="0" class="variablelist">
 
580
<colgroup>
 
581
<col align="left" valign="top">
 
582
<col>
 
583
</colgroup>
 
584
<tbody>
 
585
<tr>
 
586
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
 
587
<td>a <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>
 
588
</td>
 
589
</tr>
 
590
<tr>
 
591
<td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
 
592
<td>a valid URI</td>
 
593
</tr>
 
594
<tr>
 
595
<td><p><span class="term"><em class="parameter"><code>recent_data</code></em> :</span></p></td>
 
596
<td>metadata of the resource</td>
 
597
</tr>
 
598
<tr>
 
599
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
600
<td>
 
601
<code class="literal">TRUE</code> if the new item was successfully added to the
 
602
recently used resources list, <code class="literal">FALSE</code> otherwise.</td>
 
603
</tr>
 
604
</tbody>
 
605
</table></div>
 
606
<p class="since">Since 2.10</p>
 
607
</div>
 
608
<hr>
 
609
<div class="refsect2">
 
610
<a name="gtk-recent-manager-remove-item"></a><h3>gtk_recent_manager_remove_item ()</h3>
 
611
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_recent_manager_remove_item      (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
 
612
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *uri</code></em>,
 
613
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
 
614
<p>
 
615
Removes a resource pointed by <em class="parameter"><code>uri</code></em> from the recently used resources
 
616
list handled by a recent manager.
 
617
</p>
 
618
<div class="variablelist"><table border="0" class="variablelist">
 
619
<colgroup>
 
620
<col align="left" valign="top">
 
621
<col>
 
622
</colgroup>
 
623
<tbody>
 
624
<tr>
 
625
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
 
626
<td>a <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>
 
627
</td>
 
628
</tr>
 
629
<tr>
 
630
<td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
 
631
<td>the URI of the item you wish to remove</td>
 
632
</tr>
 
633
<tr>
 
634
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 
635
<td>return location for a <span class="type">GError</span>, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
636
</td>
 
637
</tr>
 
638
<tr>
 
639
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
640
<td>
 
641
<code class="literal">TRUE</code> if the item pointed by <em class="parameter"><code>uri</code></em> has been successfully
 
642
removed by the recently used resources list, and <code class="literal">FALSE</code> otherwise.</td>
 
643
</tr>
 
644
</tbody>
 
645
</table></div>
 
646
<p class="since">Since 2.10</p>
 
647
</div>
 
648
<hr>
 
649
<div class="refsect2">
 
650
<a name="gtk-recent-manager-lookup-item"></a><h3>gtk_recent_manager_lookup_item ()</h3>
 
651
<pre class="programlisting"><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="returnvalue">GtkRecentInfo</span></a> *     gtk_recent_manager_lookup_item      (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
 
652
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *uri</code></em>,
 
653
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
 
654
<p>
 
655
Searches for a URI inside the recently used resources list, and
 
656
returns a structure containing informations about the resource
 
657
like its MIME type, or its display name.
 
658
</p>
 
659
<div class="variablelist"><table border="0" class="variablelist">
 
660
<colgroup>
 
661
<col align="left" valign="top">
 
662
<col>
 
663
</colgroup>
 
664
<tbody>
 
665
<tr>
 
666
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
 
667
<td>a <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>
 
668
</td>
 
669
</tr>
 
670
<tr>
 
671
<td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
 
672
<td>a URI</td>
 
673
</tr>
 
674
<tr>
 
675
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 
676
<td>a return location for a <span class="type">GError</span>, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
677
</td>
 
678
</tr>
 
679
<tr>
 
680
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
681
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> structure containing information
 
682
about the resource pointed by <em class="parameter"><code>uri</code></em>, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if the URI was
 
683
not registered in the recently used resources list.  Free with
 
684
<a class="link" href="GtkRecentManager.html#gtk-recent-info-unref" title="gtk_recent_info_unref ()"><code class="function">gtk_recent_info_unref()</code></a>.</td>
 
685
</tr>
 
686
</tbody>
 
687
</table></div>
 
688
<p class="since">Since 2.10</p>
 
689
</div>
 
690
<hr>
 
691
<div class="refsect2">
 
692
<a name="gtk-recent-manager-has-item"></a><h3>gtk_recent_manager_has_item ()</h3>
 
693
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_recent_manager_has_item         (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
 
694
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *uri</code></em>);</pre>
 
695
<p>
 
696
Checks whether there is a recently used resource registered
 
697
with <em class="parameter"><code>uri</code></em> inside the recent manager.
 
698
</p>
 
699
<div class="variablelist"><table border="0" class="variablelist">
 
700
<colgroup>
 
701
<col align="left" valign="top">
 
702
<col>
 
703
</colgroup>
 
704
<tbody>
 
705
<tr>
 
706
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
 
707
<td>a <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>
 
708
</td>
 
709
</tr>
 
710
<tr>
 
711
<td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
 
712
<td>a URI</td>
 
713
</tr>
 
714
<tr>
 
715
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
716
<td>
 
717
<code class="literal">TRUE</code> if the resource was found, <code class="literal">FALSE</code> otherwise.</td>
 
718
</tr>
 
719
</tbody>
 
720
</table></div>
 
721
<p class="since">Since 2.10</p>
 
722
</div>
 
723
<hr>
 
724
<div class="refsect2">
 
725
<a name="gtk-recent-manager-move-item"></a><h3>gtk_recent_manager_move_item ()</h3>
 
726
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_recent_manager_move_item        (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
 
727
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *uri</code></em>,
 
728
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *new_uri</code></em>,
 
729
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
 
730
<p>
 
731
Changes the location of a recently used resource from <em class="parameter"><code>uri</code></em> to <em class="parameter"><code>new_uri</code></em>.
 
732
</p>
 
733
<p>
 
734
Please note that this function will not affect the resource pointed
 
735
by the URIs, but only the URI used in the recently used resources list.
 
736
</p>
 
737
<div class="variablelist"><table border="0" class="variablelist">
 
738
<colgroup>
 
739
<col align="left" valign="top">
 
740
<col>
 
741
</colgroup>
 
742
<tbody>
 
743
<tr>
 
744
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
 
745
<td>a <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>
 
746
</td>
 
747
</tr>
 
748
<tr>
 
749
<td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
 
750
<td>the URI of a recently used resource</td>
 
751
</tr>
 
752
<tr>
 
753
<td><p><span class="term"><em class="parameter"><code>new_uri</code></em> :</span></p></td>
 
754
<td>the new URI of the recently used resource, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> to
 
755
remove the item pointed by <em class="parameter"><code>uri</code></em> in the list. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
756
</td>
 
757
</tr>
 
758
<tr>
 
759
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 
760
<td>a return location for a <span class="type">GError</span>, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
761
</td>
 
762
</tr>
 
763
<tr>
 
764
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
765
<td>
 
766
<code class="literal">TRUE</code> on success.</td>
 
767
</tr>
 
768
</tbody>
 
769
</table></div>
 
770
<p class="since">Since 2.10</p>
 
771
</div>
 
772
<hr>
 
773
<div class="refsect2">
 
774
<a name="gtk-recent-manager-get-limit"></a><h3>gtk_recent_manager_get_limit ()</h3>
 
775
<pre class="programlisting"><span class="returnvalue">gint</span>                gtk_recent_manager_get_limit        (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>);</pre>
 
776
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
777
<h3 class="title">Warning</h3>
 
778
<p><code class="literal">gtk_recent_manager_get_limit</code> has been deprecated since version 2.22 and should not be used in newly-written code. The length of the list should be managed by the
 
779
  view (implementing <a class="link" href="GtkRecentChooser.html" title="GtkRecentChooser"><span class="type">GtkRecentChooser</span></a>), and not by the model (the
 
780
  <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>). See <a class="link" href="GtkRecentChooser.html#GtkRecentChooser--limit" title='The "limit" property'><span class="type">"limit"</span></a>.</p>
 
781
</div>
 
782
<p>
 
783
Gets the maximum number of items that the <a class="link" href="GtkRecentManager.html#gtk-recent-manager-get-items" title="gtk_recent_manager_get_items ()"><code class="function">gtk_recent_manager_get_items()</code></a>
 
784
function should return.
 
785
</p>
 
786
<div class="variablelist"><table border="0" class="variablelist">
 
787
<colgroup>
 
788
<col align="left" valign="top">
 
789
<col>
 
790
</colgroup>
 
791
<tbody>
 
792
<tr>
 
793
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
 
794
<td>a <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>
 
795
</td>
 
796
</tr>
 
797
<tr>
 
798
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
799
<td>the number of items to return, or -1 for every item.</td>
 
800
</tr>
 
801
</tbody>
 
802
</table></div>
 
803
<p class="since">Since 2.10</p>
 
804
</div>
 
805
<hr>
 
806
<div class="refsect2">
 
807
<a name="gtk-recent-manager-set-limit"></a><h3>gtk_recent_manager_set_limit ()</h3>
 
808
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_recent_manager_set_limit        (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
 
809
                                                         <em class="parameter"><code><span class="type">gint</span> limit</code></em>);</pre>
 
810
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
811
<h3 class="title">Warning</h3>
 
812
<p><code class="literal">gtk_recent_manager_set_limit</code> has been deprecated since version 2.22 and should not be used in newly-written code. The length of the list should be managed by the
 
813
  view (implementing <a class="link" href="GtkRecentChooser.html" title="GtkRecentChooser"><span class="type">GtkRecentChooser</span></a>), and not by the model (the
 
814
  <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>). See <a class="link" href="GtkRecentChooser.html#GtkRecentChooser--limit" title='The "limit" property'><span class="type">"limit"</span></a>.</p>
 
815
</div>
 
816
<p>
 
817
Sets the maximum number of item that the <a class="link" href="GtkRecentManager.html#gtk-recent-manager-get-items" title="gtk_recent_manager_get_items ()"><code class="function">gtk_recent_manager_get_items()</code></a>
 
818
function should return.  If <em class="parameter"><code>limit</code></em> is set to -1, then return all the
 
819
items.
 
820
</p>
 
821
<div class="variablelist"><table border="0" class="variablelist">
 
822
<colgroup>
 
823
<col align="left" valign="top">
 
824
<col>
 
825
</colgroup>
 
826
<tbody>
 
827
<tr>
 
828
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
 
829
<td>a <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>
 
830
</td>
 
831
</tr>
 
832
<tr>
 
833
<td><p><span class="term"><em class="parameter"><code>limit</code></em> :</span></p></td>
 
834
<td>the maximum number of items to return, or -1.</td>
 
835
</tr>
 
836
</tbody>
 
837
</table></div>
 
838
<p class="since">Since 2.10</p>
 
839
</div>
 
840
<hr>
 
841
<div class="refsect2">
 
842
<a name="gtk-recent-manager-get-items"></a><h3>gtk_recent_manager_get_items ()</h3>
 
843
<pre class="programlisting"><span class="returnvalue">GList</span> *             gtk_recent_manager_get_items        (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>);</pre>
 
844
<p>
 
845
Gets the list of recently used resources.
 
846
</p>
 
847
<div class="variablelist"><table border="0" class="variablelist">
 
848
<colgroup>
 
849
<col align="left" valign="top">
 
850
<col>
 
851
</colgroup>
 
852
<tbody>
 
853
<tr>
 
854
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
 
855
<td>a <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>
 
856
</td>
 
857
</tr>
 
858
<tr>
 
859
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
860
<td>a list of
 
861
newly allocated <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> objects. Use
 
862
<a class="link" href="GtkRecentManager.html#gtk-recent-info-unref" title="gtk_recent_info_unref ()"><code class="function">gtk_recent_info_unref()</code></a> on each item inside the list, and then
 
863
free the list itself using <code class="function">g_list_free()</code>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkRecentInfo][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 
864
</td>
 
865
</tr>
 
866
</tbody>
 
867
</table></div>
 
868
<p class="since">Since 2.10</p>
 
869
</div>
 
870
<hr>
 
871
<div class="refsect2">
 
872
<a name="gtk-recent-manager-purge-items"></a><h3>gtk_recent_manager_purge_items ()</h3>
 
873
<pre class="programlisting"><span class="returnvalue">gint</span>                gtk_recent_manager_purge_items      (<em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
 
874
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
 
875
<p>
 
876
Purges every item from the recently used resources list.
 
877
</p>
 
878
<div class="variablelist"><table border="0" class="variablelist">
 
879
<colgroup>
 
880
<col align="left" valign="top">
 
881
<col>
 
882
</colgroup>
 
883
<tbody>
 
884
<tr>
 
885
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
 
886
<td>a <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>
 
887
</td>
 
888
</tr>
 
889
<tr>
 
890
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 
891
<td>a return location for a <span class="type">GError</span>, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
892
</td>
 
893
</tr>
 
894
<tr>
 
895
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
896
<td>the number of items that have been removed from the
 
897
recently used resources list.</td>
 
898
</tr>
 
899
</tbody>
 
900
</table></div>
 
901
<p class="since">Since 2.10</p>
 
902
</div>
 
903
<hr>
 
904
<div class="refsect2">
 
905
<a name="gtk-recent-info-ref"></a><h3>gtk_recent_info_ref ()</h3>
 
906
<pre class="programlisting"><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="returnvalue">GtkRecentInfo</span></a> *     gtk_recent_info_ref                 (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);</pre>
 
907
<p>
 
908
Increases the reference count of <em class="parameter"><code>recent_info</code></em> by one.
 
909
</p>
 
910
<div class="variablelist"><table border="0" class="variablelist">
 
911
<colgroup>
 
912
<col align="left" valign="top">
 
913
<col>
 
914
</colgroup>
 
915
<tbody>
 
916
<tr>
 
917
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 
918
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
919
</td>
 
920
</tr>
 
921
<tr>
 
922
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
923
<td>the recent info object with its reference count increased
 
924
by one.</td>
 
925
</tr>
 
926
</tbody>
 
927
</table></div>
 
928
<p class="since">Since 2.10</p>
 
929
</div>
 
930
<hr>
 
931
<div class="refsect2">
 
932
<a name="gtk-recent-info-unref"></a><h3>gtk_recent_info_unref ()</h3>
 
933
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_recent_info_unref               (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);</pre>
 
934
<p>
 
935
Decreases the reference count of <em class="parameter"><code>info</code></em> by one.  If the reference
 
936
count reaches zero, <em class="parameter"><code>info</code></em> is deallocated, and the memory freed.
 
937
</p>
 
938
<div class="variablelist"><table border="0" class="variablelist">
 
939
<colgroup>
 
940
<col align="left" valign="top">
 
941
<col>
 
942
</colgroup>
 
943
<tbody><tr>
 
944
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 
945
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
946
</td>
 
947
</tr></tbody>
 
948
</table></div>
 
949
<p class="since">Since 2.10</p>
 
950
</div>
 
951
<hr>
 
952
<div class="refsect2">
 
953
<a name="gtk-recent-info-get-uri"></a><h3>gtk_recent_info_get_uri ()</h3>
 
954
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       gtk_recent_info_get_uri             (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);</pre>
 
955
<p>
 
956
Gets the URI of the resource.
 
957
</p>
 
958
<div class="variablelist"><table border="0" class="variablelist">
 
959
<colgroup>
 
960
<col align="left" valign="top">
 
961
<col>
 
962
</colgroup>
 
963
<tbody>
 
964
<tr>
 
965
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 
966
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
967
</td>
 
968
</tr>
 
969
<tr>
 
970
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
971
<td>the URI of the resource.  The returned string is
 
972
owned by the recent manager, and should not be freed.</td>
 
973
</tr>
 
974
</tbody>
 
975
</table></div>
 
976
<p class="since">Since 2.10</p>
 
977
</div>
 
978
<hr>
 
979
<div class="refsect2">
 
980
<a name="gtk-recent-info-get-display-name"></a><h3>gtk_recent_info_get_display_name ()</h3>
 
981
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       gtk_recent_info_get_display_name    (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);</pre>
 
982
<p>
 
983
Gets the name of the resource.  If none has been defined, the basename
 
984
of the resource is obtained.
 
985
</p>
 
986
<div class="variablelist"><table border="0" class="variablelist">
 
987
<colgroup>
 
988
<col align="left" valign="top">
 
989
<col>
 
990
</colgroup>
 
991
<tbody>
 
992
<tr>
 
993
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 
994
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
995
</td>
 
996
</tr>
 
997
<tr>
 
998
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
999
<td>the display name of the resource.  The returned string
 
1000
is owned by the recent manager, and should not be freed.</td>
 
1001
</tr>
 
1002
</tbody>
 
1003
</table></div>
 
1004
<p class="since">Since 2.10</p>
 
1005
</div>
 
1006
<hr>
 
1007
<div class="refsect2">
 
1008
<a name="gtk-recent-info-get-description"></a><h3>gtk_recent_info_get_description ()</h3>
 
1009
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       gtk_recent_info_get_description     (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);</pre>
 
1010
<p>
 
1011
Gets the (short) description of the resource.
 
1012
</p>
 
1013
<div class="variablelist"><table border="0" class="variablelist">
 
1014
<colgroup>
 
1015
<col align="left" valign="top">
 
1016
<col>
 
1017
</colgroup>
 
1018
<tbody>
 
1019
<tr>
 
1020
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 
1021
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
1022
</td>
 
1023
</tr>
 
1024
<tr>
 
1025
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1026
<td>the description of the resource.  The returned string
 
1027
is owned by the recent manager, and should not be freed.</td>
 
1028
</tr>
 
1029
</tbody>
 
1030
</table></div>
 
1031
<p class="since">Since 2.10</p>
 
1032
</div>
 
1033
<hr>
 
1034
<div class="refsect2">
 
1035
<a name="gtk-recent-info-get-mime-type"></a><h3>gtk_recent_info_get_mime_type ()</h3>
 
1036
<pre class="programlisting">const <span class="returnvalue">gchar</span> *       gtk_recent_info_get_mime_type       (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);</pre>
 
1037
<p>
 
1038
Gets the MIME type of the resource.
 
1039
</p>
 
1040
<div class="variablelist"><table border="0" class="variablelist">
 
1041
<colgroup>
 
1042
<col align="left" valign="top">
 
1043
<col>
 
1044
</colgroup>
 
1045
<tbody>
 
1046
<tr>
 
1047
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 
1048
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
1049
</td>
 
1050
</tr>
 
1051
<tr>
 
1052
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1053
<td>the MIME type of the resource.  The returned string
 
1054
is owned by the recent manager, and should not be freed.</td>
 
1055
</tr>
 
1056
</tbody>
 
1057
</table></div>
 
1058
<p class="since">Since 2.10</p>
 
1059
</div>
 
1060
<hr>
 
1061
<div class="refsect2">
 
1062
<a name="gtk-recent-info-get-added"></a><h3>gtk_recent_info_get_added ()</h3>
 
1063
<pre class="programlisting"><span class="returnvalue">time_t</span>              gtk_recent_info_get_added           (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);</pre>
 
1064
<p>
 
1065
Gets the timestamp (seconds from system's Epoch) when the resource
 
1066
was added to the recently used resources list.
 
1067
</p>
 
1068
<div class="variablelist"><table border="0" class="variablelist">
 
1069
<colgroup>
 
1070
<col align="left" valign="top">
 
1071
<col>
 
1072
</colgroup>
 
1073
<tbody>
 
1074
<tr>
 
1075
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 
1076
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
1077
</td>
 
1078
</tr>
 
1079
<tr>
 
1080
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1081
<td>the number of seconds elapsed from system's Epoch when
 
1082
the resource was added to the list, or -1 on failure.</td>
 
1083
</tr>
 
1084
</tbody>
 
1085
</table></div>
 
1086
<p class="since">Since 2.10</p>
 
1087
</div>
 
1088
<hr>
 
1089
<div class="refsect2">
 
1090
<a name="gtk-recent-info-get-modified"></a><h3>gtk_recent_info_get_modified ()</h3>
 
1091
<pre class="programlisting"><span class="returnvalue">time_t</span>              gtk_recent_info_get_modified        (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);</pre>
 
1092
<p>
 
1093
Gets the timestamp (seconds from system's Epoch) when the resource
 
1094
was last modified.
 
1095
</p>
 
1096
<div class="variablelist"><table border="0" class="variablelist">
 
1097
<colgroup>
 
1098
<col align="left" valign="top">
 
1099
<col>
 
1100
</colgroup>
 
1101
<tbody>
 
1102
<tr>
 
1103
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 
1104
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
1105
</td>
 
1106
</tr>
 
1107
<tr>
 
1108
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1109
<td>the number of seconds elapsed from system's Epoch when
 
1110
the resource was last modified, or -1 on failure.</td>
 
1111
</tr>
 
1112
</tbody>
 
1113
</table></div>
 
1114
<p class="since">Since 2.10</p>
 
1115
</div>
 
1116
<hr>
 
1117
<div class="refsect2">
 
1118
<a name="gtk-recent-info-get-visited"></a><h3>gtk_recent_info_get_visited ()</h3>
 
1119
<pre class="programlisting"><span class="returnvalue">time_t</span>              gtk_recent_info_get_visited         (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);</pre>
 
1120
<p>
 
1121
Gets the timestamp (seconds from system's Epoch) when the resource
 
1122
was last visited.
 
1123
</p>
 
1124
<div class="variablelist"><table border="0" class="variablelist">
 
1125
<colgroup>
 
1126
<col align="left" valign="top">
 
1127
<col>
 
1128
</colgroup>
 
1129
<tbody>
 
1130
<tr>
 
1131
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 
1132
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
1133
</td>
 
1134
</tr>
 
1135
<tr>
 
1136
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1137
<td>the number of seconds elapsed from system's Epoch when
 
1138
the resource was last visited, or -1 on failure.</td>
 
1139
</tr>
 
1140
</tbody>
 
1141
</table></div>
 
1142
<p class="since">Since 2.10</p>
 
1143
</div>
 
1144
<hr>
 
1145
<div class="refsect2">
 
1146
<a name="gtk-recent-info-get-private-hint"></a><h3>gtk_recent_info_get_private_hint ()</h3>
 
1147
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_recent_info_get_private_hint    (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);</pre>
 
1148
<p>
 
1149
Gets the value of the "private" flag.  Resources in the recently used
 
1150
list that have this flag set to <code class="literal">TRUE</code> should only be displayed by the
 
1151
applications that have registered them.
 
1152
</p>
 
1153
<div class="variablelist"><table border="0" class="variablelist">
 
1154
<colgroup>
 
1155
<col align="left" valign="top">
 
1156
<col>
 
1157
</colgroup>
 
1158
<tbody>
 
1159
<tr>
 
1160
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 
1161
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
1162
</td>
 
1163
</tr>
 
1164
<tr>
 
1165
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1166
<td>
 
1167
<code class="literal">TRUE</code> if the private flag was found, <code class="literal">FALSE</code> otherwise.</td>
 
1168
</tr>
 
1169
</tbody>
 
1170
</table></div>
 
1171
<p class="since">Since 2.10</p>
 
1172
</div>
 
1173
<hr>
 
1174
<div class="refsect2">
 
1175
<a name="gtk-recent-info-get-application-info"></a><h3>gtk_recent_info_get_application_info ()</h3>
 
1176
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_recent_info_get_application_info
 
1177
                                                        (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>,
 
1178
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *app_name</code></em>,
 
1179
                                                         <em class="parameter"><code>const <span class="type">gchar</span> **app_exec</code></em>,
 
1180
                                                         <em class="parameter"><code><span class="type">guint</span> *count</code></em>,
 
1181
                                                         <em class="parameter"><code><span class="type">time_t</span> *time_</code></em>);</pre>
 
1182
<p>
 
1183
Gets the data regarding the application that has registered the resource
 
1184
pointed by <em class="parameter"><code>info</code></em>.
 
1185
</p>
 
1186
<p>
 
1187
If the command line contains any escape characters defined inside the
 
1188
storage specification, they will be expanded.
 
1189
</p>
 
1190
<div class="variablelist"><table border="0" class="variablelist">
 
1191
<colgroup>
 
1192
<col align="left" valign="top">
 
1193
<col>
 
1194
</colgroup>
 
1195
<tbody>
 
1196
<tr>
 
1197
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 
1198
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
1199
</td>
 
1200
</tr>
 
1201
<tr>
 
1202
<td><p><span class="term"><em class="parameter"><code>app_name</code></em> :</span></p></td>
 
1203
<td>the name of the application that has registered this item</td>
 
1204
</tr>
 
1205
<tr>
 
1206
<td><p><span class="term"><em class="parameter"><code>app_exec</code></em> :</span></p></td>
 
1207
<td>return location for the string containing the command line. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
 
1208
</td>
 
1209
</tr>
 
1210
<tr>
 
1211
<td><p><span class="term"><em class="parameter"><code>count</code></em> :</span></p></td>
 
1212
<td>return location for the number of times this item was registered. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
 
1213
</td>
 
1214
</tr>
 
1215
<tr>
 
1216
<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
 
1217
<td>return location for the timestamp this item was last registered
 
1218
for this application. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
 
1219
</td>
 
1220
</tr>
 
1221
<tr>
 
1222
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1223
<td>
 
1224
<code class="literal">TRUE</code> if an application with <em class="parameter"><code>app_name</code></em> has registered this
 
1225
resource inside the recently used list, or <code class="literal">FALSE</code> otherwise. The
 
1226
<em class="parameter"><code>app_exec</code></em> string is owned by the <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> and should not be
 
1227
modified or freed</td>
 
1228
</tr>
 
1229
</tbody>
 
1230
</table></div>
 
1231
<p class="since">Since 2.10</p>
 
1232
</div>
 
1233
<hr>
 
1234
<div class="refsect2">
 
1235
<a name="gtk-recent-info-get-applications"></a><h3>gtk_recent_info_get_applications ()</h3>
 
1236
<pre class="programlisting"><span class="returnvalue">gchar</span> **            gtk_recent_info_get_applications    (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>,
 
1237
                                                         <em class="parameter"><code><span class="type">gsize</span> *length</code></em>);</pre>
 
1238
<p>
 
1239
Retrieves the list of applications that have registered this resource.
 
1240
</p>
 
1241
<div class="variablelist"><table border="0" class="variablelist">
 
1242
<colgroup>
 
1243
<col align="left" valign="top">
 
1244
<col>
 
1245
</colgroup>
 
1246
<tbody>
 
1247
<tr>
 
1248
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 
1249
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
1250
</td>
 
1251
</tr>
 
1252
<tr>
 
1253
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
 
1254
<td>return location for the length of the returned list. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
1255
</td>
 
1256
</tr>
 
1257
<tr>
 
1258
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1259
<td>a newly allocated <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of strings.
 
1260
Use <code class="function">g_strfreev()</code> to free it. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length zero-terminated=1][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 
1261
</td>
 
1262
</tr>
 
1263
</tbody>
 
1264
</table></div>
 
1265
<p class="since">Since 2.10</p>
 
1266
</div>
 
1267
<hr>
 
1268
<div class="refsect2">
 
1269
<a name="gtk-recent-info-last-application"></a><h3>gtk_recent_info_last_application ()</h3>
 
1270
<pre class="programlisting"><span class="returnvalue">gchar</span> *             gtk_recent_info_last_application    (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);</pre>
 
1271
<p>
 
1272
Gets the name of the last application that have registered the
 
1273
recently used resource represented by <em class="parameter"><code>info</code></em>.
 
1274
</p>
 
1275
<div class="variablelist"><table border="0" class="variablelist">
 
1276
<colgroup>
 
1277
<col align="left" valign="top">
 
1278
<col>
 
1279
</colgroup>
 
1280
<tbody>
 
1281
<tr>
 
1282
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 
1283
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
1284
</td>
 
1285
</tr>
 
1286
<tr>
 
1287
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1288
<td>an application name.  Use <code class="function">g_free()</code> to free it.</td>
 
1289
</tr>
 
1290
</tbody>
 
1291
</table></div>
 
1292
<p class="since">Since 2.10</p>
 
1293
</div>
 
1294
<hr>
 
1295
<div class="refsect2">
 
1296
<a name="gtk-recent-info-get-groups"></a><h3>gtk_recent_info_get_groups ()</h3>
 
1297
<pre class="programlisting"><span class="returnvalue">gchar</span> **            gtk_recent_info_get_groups          (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>,
 
1298
                                                         <em class="parameter"><code><span class="type">gsize</span> *length</code></em>);</pre>
 
1299
<p>
 
1300
Returns all groups registered for the recently used item <em class="parameter"><code>info</code></em>.  The
 
1301
array of returned group names will be <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> terminated, so length might
 
1302
optionally be <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.
 
1303
</p>
 
1304
<div class="variablelist"><table border="0" class="variablelist">
 
1305
<colgroup>
 
1306
<col align="left" valign="top">
 
1307
<col>
 
1308
</colgroup>
 
1309
<tbody>
 
1310
<tr>
 
1311
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 
1312
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
1313
</td>
 
1314
</tr>
 
1315
<tr>
 
1316
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
 
1317
<td>return location for the number of groups returned. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
1318
</td>
 
1319
</tr>
 
1320
<tr>
 
1321
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1322
<td>a newly allocated <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> terminated array of strings.
 
1323
Use <code class="function">g_strfreev()</code> to free it. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length zero-terminated=1][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 
1324
</td>
 
1325
</tr>
 
1326
</tbody>
 
1327
</table></div>
 
1328
<p class="since">Since 2.10</p>
 
1329
</div>
 
1330
<hr>
 
1331
<div class="refsect2">
 
1332
<a name="gtk-recent-info-has-group"></a><h3>gtk_recent_info_has_group ()</h3>
 
1333
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_recent_info_has_group           (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>,
 
1334
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *group_name</code></em>);</pre>
 
1335
<p>
 
1336
Checks whether <em class="parameter"><code>group_name</code></em> appears inside the groups registered for the
 
1337
recently used item <em class="parameter"><code>info</code></em>.
 
1338
</p>
 
1339
<div class="variablelist"><table border="0" class="variablelist">
 
1340
<colgroup>
 
1341
<col align="left" valign="top">
 
1342
<col>
 
1343
</colgroup>
 
1344
<tbody>
 
1345
<tr>
 
1346
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 
1347
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
1348
</td>
 
1349
</tr>
 
1350
<tr>
 
1351
<td><p><span class="term"><em class="parameter"><code>group_name</code></em> :</span></p></td>
 
1352
<td>name of a group</td>
 
1353
</tr>
 
1354
<tr>
 
1355
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1356
<td>
 
1357
<code class="literal">TRUE</code> if the group was found.</td>
 
1358
</tr>
 
1359
</tbody>
 
1360
</table></div>
 
1361
<p class="since">Since 2.10</p>
 
1362
</div>
 
1363
<hr>
 
1364
<div class="refsect2">
 
1365
<a name="gtk-recent-info-has-application"></a><h3>gtk_recent_info_has_application ()</h3>
 
1366
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_recent_info_has_application     (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>,
 
1367
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *app_name</code></em>);</pre>
 
1368
<p>
 
1369
Checks whether an application registered this resource using <em class="parameter"><code>app_name</code></em>.
 
1370
</p>
 
1371
<div class="variablelist"><table border="0" class="variablelist">
 
1372
<colgroup>
 
1373
<col align="left" valign="top">
 
1374
<col>
 
1375
</colgroup>
 
1376
<tbody>
 
1377
<tr>
 
1378
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 
1379
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
1380
</td>
 
1381
</tr>
 
1382
<tr>
 
1383
<td><p><span class="term"><em class="parameter"><code>app_name</code></em> :</span></p></td>
 
1384
<td>a string containing an application name</td>
 
1385
</tr>
 
1386
<tr>
 
1387
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1388
<td>
 
1389
<code class="literal">TRUE</code> if an application with name <em class="parameter"><code>app_name</code></em> was found,
 
1390
<code class="literal">FALSE</code> otherwise.</td>
 
1391
</tr>
 
1392
</tbody>
 
1393
</table></div>
 
1394
<p class="since">Since 2.10</p>
 
1395
</div>
 
1396
<hr>
 
1397
<div class="refsect2">
 
1398
<a name="gtk-recent-info-get-icon"></a><h3>gtk_recent_info_get_icon ()</h3>
 
1399
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a> *         gtk_recent_info_get_icon            (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>,
 
1400
                                                         <em class="parameter"><code><span class="type">gint</span> size</code></em>);</pre>
 
1401
<p>
 
1402
Retrieves the icon of size <em class="parameter"><code>size</code></em> associated to the resource MIME type.
 
1403
</p>
 
1404
<div class="variablelist"><table border="0" class="variablelist">
 
1405
<colgroup>
 
1406
<col align="left" valign="top">
 
1407
<col>
 
1408
</colgroup>
 
1409
<tbody>
 
1410
<tr>
 
1411
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 
1412
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
1413
</td>
 
1414
</tr>
 
1415
<tr>
 
1416
<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
 
1417
<td>the size of the icon in pixels</td>
 
1418
</tr>
 
1419
<tr>
 
1420
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1421
<td>a <a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> containing the icon,
 
1422
or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. Use <code class="function">g_object_unref()</code> when finished using the icon. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 
1423
</td>
 
1424
</tr>
 
1425
</tbody>
 
1426
</table></div>
 
1427
<p class="since">Since 2.10</p>
 
1428
</div>
 
1429
<hr>
 
1430
<div class="refsect2">
 
1431
<a name="gtk-recent-info-get-short-name"></a><h3>gtk_recent_info_get_short_name ()</h3>
 
1432
<pre class="programlisting"><span class="returnvalue">gchar</span> *             gtk_recent_info_get_short_name      (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);</pre>
 
1433
<p>
 
1434
Computes a valid UTF-8 string that can be used as the name of the item in a
 
1435
menu or list.  For example, calling this function on an item that refers to
 
1436
"file:///foo/bar.txt" will yield "bar.txt".
 
1437
</p>
 
1438
<div class="variablelist"><table border="0" class="variablelist">
 
1439
<colgroup>
 
1440
<col align="left" valign="top">
 
1441
<col>
 
1442
</colgroup>
 
1443
<tbody>
 
1444
<tr>
 
1445
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 
1446
<td>an <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
1447
</td>
 
1448
</tr>
 
1449
<tr>
 
1450
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1451
<td>A newly-allocated string in UTF-8 encoding; free it with
 
1452
<code class="function">g_free()</code>.</td>
 
1453
</tr>
 
1454
</tbody>
 
1455
</table></div>
 
1456
<p class="since">Since 2.10</p>
 
1457
</div>
 
1458
<hr>
 
1459
<div class="refsect2">
 
1460
<a name="gtk-recent-info-get-uri-display"></a><h3>gtk_recent_info_get_uri_display ()</h3>
 
1461
<pre class="programlisting"><span class="returnvalue">gchar</span> *             gtk_recent_info_get_uri_display     (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);</pre>
 
1462
<p>
 
1463
Gets a displayable version of the resource's URI.  If the resource
 
1464
is local, it returns a local path; if the resource is not local,
 
1465
it returns the UTF-8 encoded content of <a class="link" href="GtkRecentManager.html#gtk-recent-info-get-uri" title="gtk_recent_info_get_uri ()"><code class="function">gtk_recent_info_get_uri()</code></a>.
 
1466
</p>
 
1467
<div class="variablelist"><table border="0" class="variablelist">
 
1468
<colgroup>
 
1469
<col align="left" valign="top">
 
1470
<col>
 
1471
</colgroup>
 
1472
<tbody>
 
1473
<tr>
 
1474
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 
1475
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
1476
</td>
 
1477
</tr>
 
1478
<tr>
 
1479
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1480
<td>a newly allocated UTF-8 string containing the
 
1481
resource's URI or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. Use <code class="function">g_free()</code> when done using it.</td>
 
1482
</tr>
 
1483
</tbody>
 
1484
</table></div>
 
1485
<p class="since">Since 2.10</p>
 
1486
</div>
 
1487
<hr>
 
1488
<div class="refsect2">
 
1489
<a name="gtk-recent-info-get-age"></a><h3>gtk_recent_info_get_age ()</h3>
 
1490
<pre class="programlisting"><span class="returnvalue">gint</span>                gtk_recent_info_get_age             (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);</pre>
 
1491
<p>
 
1492
Gets the number of days elapsed since the last update of the resource
 
1493
pointed by <em class="parameter"><code>info</code></em>.
 
1494
</p>
 
1495
<div class="variablelist"><table border="0" class="variablelist">
 
1496
<colgroup>
 
1497
<col align="left" valign="top">
 
1498
<col>
 
1499
</colgroup>
 
1500
<tbody>
 
1501
<tr>
 
1502
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 
1503
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
1504
</td>
 
1505
</tr>
 
1506
<tr>
 
1507
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1508
<td>a positive integer containing the number of days elapsed
 
1509
since the time this resource was last modified.</td>
 
1510
</tr>
 
1511
</tbody>
 
1512
</table></div>
 
1513
<p class="since">Since 2.10</p>
 
1514
</div>
 
1515
<hr>
 
1516
<div class="refsect2">
 
1517
<a name="gtk-recent-info-is-local"></a><h3>gtk_recent_info_is_local ()</h3>
 
1518
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_recent_info_is_local            (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);</pre>
 
1519
<p>
 
1520
Checks whether the resource is local or not by looking at the
 
1521
scheme of its URI.
 
1522
</p>
 
1523
<div class="variablelist"><table border="0" class="variablelist">
 
1524
<colgroup>
 
1525
<col align="left" valign="top">
 
1526
<col>
 
1527
</colgroup>
 
1528
<tbody>
 
1529
<tr>
 
1530
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 
1531
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
1532
</td>
 
1533
</tr>
 
1534
<tr>
 
1535
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1536
<td>
 
1537
<code class="literal">TRUE</code> if the resource is local.</td>
 
1538
</tr>
 
1539
</tbody>
 
1540
</table></div>
 
1541
<p class="since">Since 2.10</p>
 
1542
</div>
 
1543
<hr>
 
1544
<div class="refsect2">
 
1545
<a name="gtk-recent-info-exists"></a><h3>gtk_recent_info_exists ()</h3>
 
1546
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_recent_info_exists              (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info</code></em>);</pre>
 
1547
<p>
 
1548
Checks whether the resource pointed by <em class="parameter"><code>info</code></em> still exists.  At
 
1549
the moment this check is done only on resources pointing to local files.
 
1550
</p>
 
1551
<div class="variablelist"><table border="0" class="variablelist">
 
1552
<colgroup>
 
1553
<col align="left" valign="top">
 
1554
<col>
 
1555
</colgroup>
 
1556
<tbody>
 
1557
<tr>
 
1558
<td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 
1559
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
1560
</td>
 
1561
</tr>
 
1562
<tr>
 
1563
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1564
<td>
 
1565
<code class="literal">TRUE</code> if the resource exists</td>
 
1566
</tr>
 
1567
</tbody>
 
1568
</table></div>
 
1569
<p class="since">Since 2.10</p>
 
1570
</div>
 
1571
<hr>
 
1572
<div class="refsect2">
 
1573
<a name="gtk-recent-info-match"></a><h3>gtk_recent_info_match ()</h3>
 
1574
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_recent_info_match               (<em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info_a</code></em>,
 
1575
                                                         <em class="parameter"><code><a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> *info_b</code></em>);</pre>
 
1576
<p>
 
1577
Checks whether two <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> structures point to the same
 
1578
resource.
 
1579
</p>
 
1580
<div class="variablelist"><table border="0" class="variablelist">
 
1581
<colgroup>
 
1582
<col align="left" valign="top">
 
1583
<col>
 
1584
</colgroup>
 
1585
<tbody>
 
1586
<tr>
 
1587
<td><p><span class="term"><em class="parameter"><code>info_a</code></em> :</span></p></td>
 
1588
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
1589
</td>
 
1590
</tr>
 
1591
<tr>
 
1592
<td><p><span class="term"><em class="parameter"><code>info_b</code></em> :</span></p></td>
 
1593
<td>a <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a>
 
1594
</td>
 
1595
</tr>
 
1596
<tr>
 
1597
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
1598
<td>
 
1599
<code class="literal">TRUE</code> if both <a class="link" href="GtkRecentManager.html#GtkRecentInfo" title="GtkRecentInfo"><span class="type">GtkRecentInfo</span></a> structures point to se same
 
1600
resource, <code class="literal">FALSE</code> otherwise.</td>
 
1601
</tr>
 
1602
</tbody>
 
1603
</table></div>
 
1604
<p class="since">Since 2.10</p>
 
1605
</div>
 
1606
</div>
 
1607
<div class="refsect1">
 
1608
<a name="GtkRecentManager.property-details"></a><h2>Property Details</h2>
 
1609
<div class="refsect2">
 
1610
<a name="GtkRecentManager--filename"></a><h3>The <code class="literal">"filename"</code> property</h3>
 
1611
<pre class="programlisting">  "filename"                 <span class="type">gchar</span>*                : Read / Write / Construct Only</pre>
 
1612
<p>
 
1613
The full path to the file to be used to store and read the recently
 
1614
used resources list
 
1615
</p>
 
1616
<p>Default value: NULL</p>
 
1617
<p class="since">Since 2.10</p>
 
1618
</div>
 
1619
<hr>
 
1620
<div class="refsect2">
 
1621
<a name="GtkRecentManager--limit"></a><h3>The <code class="literal">"limit"</code> property</h3>
 
1622
<pre class="programlisting">  "limit"                    <span class="type">gint</span>                  : Read / Write</pre>
 
1623
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 
1624
<h3 class="title">Warning</h3>
 
1625
<p><code class="literal">GtkRecentManager:limit</code> has been deprecated since version 2.22 and should not be used in newly-written code. Setting this property does not have any effect.
 
1626
  The length of the list should be managed by the view (implementing
 
1627
  <a class="link" href="GtkRecentChooser.html" title="GtkRecentChooser"><span class="type">GtkRecentChooser</span></a>), and not by the model (the <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>).
 
1628
  See <a class="link" href="GtkRecentChooser.html#GtkRecentChooser--limit" title='The "limit" property'><span class="type">"limit"</span></a>.</p>
 
1629
</div>
 
1630
<p>
 
1631
The maximum number of items to be returned by the
 
1632
<a class="link" href="GtkRecentManager.html#gtk-recent-manager-get-items" title="gtk_recent_manager_get_items ()"><code class="function">gtk_recent_manager_get_items()</code></a> function.
 
1633
</p>
 
1634
<p>Allowed values: &gt;= G_MAXULONG</p>
 
1635
<p>Default value: -1</p>
 
1636
<p class="since">Since 2.10</p>
 
1637
</div>
 
1638
<hr>
 
1639
<div class="refsect2">
 
1640
<a name="GtkRecentManager--size"></a><h3>The <code class="literal">"size"</code> property</h3>
 
1641
<pre class="programlisting">  "size"                     <span class="type">gint</span>                  : Read</pre>
 
1642
<p>
 
1643
The size of the recently used resources list.
 
1644
</p>
 
1645
<p>Allowed values: &gt;= G_MAXULONG</p>
 
1646
<p>Default value: 0</p>
 
1647
<p class="since">Since 2.10</p>
 
1648
</div>
 
1649
</div>
 
1650
<div class="refsect1">
 
1651
<a name="GtkRecentManager.signal-details"></a><h2>Signal Details</h2>
 
1652
<div class="refsect2">
 
1653
<a name="GtkRecentManager-changed"></a><h3>The <code class="literal">"changed"</code> signal</h3>
 
1654
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *recent_manager,
 
1655
                                                        <span class="type">gpointer</span>          user_data)           : <code class="literal">Run First</code></pre>
 
1656
<p>
 
1657
Emitted when the current recently used resources manager changes its
 
1658
contents.
 
1659
</p>
 
1660
<div class="variablelist"><table border="0" class="variablelist">
 
1661
<colgroup>
 
1662
<col align="left" valign="top">
 
1663
<col>
 
1664
</colgroup>
 
1665
<tbody>
 
1666
<tr>
 
1667
<td><p><span class="term"><em class="parameter"><code>recent_manager</code></em> :</span></p></td>
 
1668
<td>the recent manager</td>
 
1669
</tr>
 
1670
<tr>
 
1671
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 
1672
<td>user data set when the signal handler was connected.</td>
 
1673
</tr>
 
1674
</tbody>
 
1675
</table></div>
 
1676
<p class="since">Since 2.10</p>
 
1677
</div>
 
1678
</div>
 
1679
</div>
 
1680
<div class="footer">
 
1681
<hr>
 
1682
          Generated by GTK-Doc V1.18</div>
 
1683
</body>
 
1684
</html>
 
 
b'\\ No newline at end of file'