1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
<title>GtkRecentChooserMenu</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
7
<link rel="start" href="index.html" title="GTK+ Reference Manual">
8
<link rel="up" href="RecentDocuments.html" title="Recently Used Documents">
9
<link rel="prev" href="GtkRecentChooserDialog.html" title="GtkRecentChooserDialog">
10
<link rel="next" href="GtkRecentChooserWidget.html" title="GtkRecentChooserWidget">
11
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
12
<link rel="stylesheet" href="style.css" type="text/css">
13
<link rel="part" href="gtk.html" title="Part I. GTK+ Overview">
14
<link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference">
15
<link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects">
16
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
17
<link rel="chapter" href="ch02.html" title="Widget Gallery">
18
<link rel="chapter" href="WindowWidgets.html" title="Windows">
19
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
20
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
21
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
22
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
23
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
24
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
25
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
26
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
27
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
28
<link rel="chapter" href="Ornaments.html" title="Ornaments">
29
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
30
<link rel="chapter" href="Printing.html" title="Printing">
31
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
32
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
33
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
34
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
35
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
36
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
37
<link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
38
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
39
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
40
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
41
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and GtkComboBoxEntry">
42
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
43
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
44
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
45
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
46
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
47
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
48
<link rel="part" href="pt05.html" title="Part V. GTK+ Tools">
49
<link rel="glossary" href="glossary.html" title="Glossary">
50
<link rel="index" href="ix01.html" title="Index">
51
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
52
<link rel="index" href="ix03.html" title="Index of new symbols in 2.2">
53
<link rel="index" href="ix04.html" title="Index of new symbols in 2.4">
54
<link rel="index" href="ix05.html" title="Index of new symbols in 2.6">
55
<link rel="index" href="ix06.html" title="Index of new symbols in 2.8">
56
<link rel="index" href="ix07.html" title="Index of new symbols in 2.10">
58
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
59
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
61
<td><a accesskey="p" href="GtkRecentChooserDialog.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
62
<td><a accesskey="u" href="RecentDocuments.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
63
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
64
<th width="100%" align="center">GTK+ Reference Manual</th>
65
<td><a accesskey="n" href="GtkRecentChooserWidget.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
67
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3864088" class="shortcut">Top</a>
69
<a href="#id3864340" class="shortcut">Description</a>
71
<a href="#id3864207" class="shortcut">Object Hierarchy</a>
73
<a href="#id3864276" class="shortcut">Implemented Interfaces</a>
75
<a href="#id3864306" class="shortcut">Properties</a></nobr></td></tr>
77
<div class="refentry" lang="en">
78
<a name="GtkRecentChooserMenu"></a><div class="titlepage"></div>
79
<div class="refnamediv"><table width="100%"><tr>
82
<a name="id3864088"></a><span class="refentrytitle">GtkRecentChooserMenu</span>
84
<p>GtkRecentChooserMenu — Displays recently used files in a menu</p>
86
<td valign="top" align="right"></td>
88
<div class="refsynopsisdiv">
90
<pre class="synopsis">
92
#include <gtk/gtk.h>
95
<a href="GtkRecentChooserMenu.html#GtkRecentChooserMenu-struct">GtkRecentChooserMenu</a>;
96
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a href="GtkRecentChooserMenu.html#gtk-recent-chooser-menu-new">gtk_recent_chooser_menu_new</a> (void);
97
<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* <a href="GtkRecentChooserMenu.html#gtk-recent-chooser-menu-new-for-manager">gtk_recent_chooser_menu_new_for_manager</a>
98
(<a href="GtkRecentManager.html" title="GtkRecentManager">GtkRecentManager</a> *manager);
99
gboolean <a href="GtkRecentChooserMenu.html#gtk-recent-chooser-menu-get-show-numbers">gtk_recent_chooser_menu_get_show_numbers</a>
100
(<a href="GtkRecentChooserMenu.html" title="GtkRecentChooserMenu">GtkRecentChooserMenu</a> *menu);
101
void <a href="GtkRecentChooserMenu.html#gtk-recent-chooser-menu-set-show-numbers">gtk_recent_chooser_menu_set_show_numbers</a>
102
(<a href="GtkRecentChooserMenu.html" title="GtkRecentChooserMenu">GtkRecentChooserMenu</a> *menu,
103
gboolean show_numbers);
108
<div class="refsect1" lang="en">
109
<a name="id3864207"></a><h2>Object Hierarchy</h2>
110
<pre class="synopsis">
113
+----GInitiallyUnowned
114
+----<a href="GtkObject.html" title="GtkObject">GtkObject</a>
115
+----<a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
116
+----<a href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
117
+----<a href="GtkMenuShell.html" title="GtkMenuShell">GtkMenuShell</a>
118
+----<a href="GtkMenu.html" title="GtkMenu">GtkMenu</a>
119
+----GtkRecentChooserMenu
122
<div class="refsect1" lang="en">
123
<a name="id3864276"></a><h2>Implemented Interfaces</h2>
125
GtkRecentChooserMenu implements
126
AtkImplementorIface and <a href="GtkRecentChooser.html" title="GtkRecentChooser">GtkRecentChooser</a>.</p>
128
<div class="refsect1" lang="en">
129
<a name="id3864306"></a><h2>Properties</h2>
130
<pre class="synopsis">
132
"<a href="GtkRecentChooserMenu.html#GtkRecentChooserMenu--show-numbers">show-numbers</a>" gboolean : Read / Write
135
<div class="refsect1" lang="en">
136
<a name="id3864340"></a><h2>Description</h2>
138
<a href="GtkRecentChooserMenu.html" title="GtkRecentChooserMenu"><span class="type">GtkRecentChooserMenu</span></a> is a widget suitable for displaying recently used files
139
inside a menu. It can be used to set a sub-menu of a <a href="GtkMenuItem.html" title="GtkMenuItem"><span class="type">GtkMenuItem</span></a> using
140
<a href="GtkMenuItem.html#gtk-menu-item-set-submenu"><code class="function">gtk_menu_item_set_submenu()</code></a>, or as the menu of a <a href="GtkMenuToolButton.html" title="GtkMenuToolButton"><span class="type">GtkMenuToolButton</span></a>.
143
Note that <a href="GtkRecentChooserMenu.html" title="GtkRecentChooserMenu"><span class="type">GtkRecentChooserMenu</span></a> does not have any methods of its own. Instead,
144
you should use the functions that work on a <a href="GtkRecentChooser.html" title="GtkRecentChooser"><span class="type">GtkRecentChooser</span></a>.
147
Note also that <a href="GtkRecentChooserMenu.html" title="GtkRecentChooserMenu"><span class="type">GtkRecentChooserMenu</span></a> does not support multiple filters, as it
148
has no way to let the user choose between them as the <a href="GtkRecentChooserWidget.html" title="GtkRecentChooserWidget"><span class="type">GtkRecentChooserWidget</span></a>
149
and <a href="GtkRecentChooserDialog.html" title="GtkRecentChooserDialog"><span class="type">GtkRecentChooserDialog</span></a> widgets do. Thus using <a href="GtkRecentChooser.html#gtk-recent-chooser-add-filter"><code class="function">gtk_recent_chooser_add_filter()</code></a>
150
on a <a href="GtkRecentChooserMenu.html" title="GtkRecentChooserMenu"><span class="type">GtkRecentChooserMenu</span></a> widget will yield the same effects as using
151
<a href="GtkRecentChooser.html#gtk-recent-chooser-set-filter"><code class="function">gtk_recent_chooser_set_filter()</code></a>, replacing any currently set filter
152
with the supplied filter; <a href="GtkRecentChooser.html#gtk-recent-chooser-remove-filter"><code class="function">gtk_recent_chooser_remove_filter()</code></a> will remove
153
any currently set <a href="GtkRecentFilter.html" title="GtkRecentFilter"><span class="type">GtkRecentFilter</span></a> object and will unset the current filter;
154
<a href="GtkRecentChooser.html#gtk-recent-chooser-list-filters"><code class="function">gtk_recent_chooser_list_filters()</code></a> will return a list containing a single
155
<a href="GtkRecentFilter.html" title="GtkRecentFilter"><span class="type">GtkRecentFilter</span></a> object.
158
Recently used files are supported since GTK+ 2.10.
161
<div class="refsect1" lang="en">
162
<a name="id3864525"></a><h2>Details</h2>
163
<div class="refsect2" lang="en">
164
<a name="id3864535"></a><h3>
165
<a name="GtkRecentChooserMenu-struct"></a>GtkRecentChooserMenu</h3>
166
<a class="indexterm" name="id3864548"></a><pre class="programlisting">typedef struct _GtkRecentChooserMenu GtkRecentChooserMenu;</pre>
172
<div class="refsect2" lang="en">
173
<a name="id3864564"></a><h3>
174
<a name="gtk-recent-chooser-menu-new"></a>gtk_recent_chooser_menu_new ()</h3>
175
<a class="indexterm" name="id3864580"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_recent_chooser_menu_new (void);</pre>
177
Creates a new <a href="GtkRecentChooserMenu.html" title="GtkRecentChooserMenu"><span class="type">GtkRecentChooserMenu</span></a> widget.
180
This kind of widget shows the list of recently used resources as
181
a menu, each item as a menu item. Each item inside the menu might
182
have an icon, representing its MIME type, and a number, for mnemonic
186
This widget implements the <a href="GtkRecentChooser.html" title="GtkRecentChooser"><span class="type">GtkRecentChooser</span></a> interface.
189
This widget creates its own <a href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> object. See the
190
<a href="GtkRecentChooserMenu.html#gtk-recent-chooser-menu-new-for-manager"><code class="function">gtk_recent_chooser_menu_new_for_manager()</code></a> function to know how to create
191
a <a href="GtkRecentChooserMenu.html" title="GtkRecentChooserMenu"><span class="type">GtkRecentChooserMenu</span></a> widget bound to another <a href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> object.</p>
195
<div class="variablelist"><table border="0">
196
<col align="left" valign="top">
198
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
199
<td> a new <a href="GtkRecentChooserMenu.html" title="GtkRecentChooserMenu"><span class="type">GtkRecentChooserMenu</span></a>
204
<p class="since">Since 2.10
208
<div class="refsect2" lang="en">
209
<a name="id3864706"></a><h3>
210
<a name="gtk-recent-chooser-menu-new-for-manager"></a>gtk_recent_chooser_menu_new_for_manager ()</h3>
211
<a class="indexterm" name="id3864722"></a><pre class="programlisting"><a href="GtkWidget.html" title="GtkWidget">GtkWidget</a>* gtk_recent_chooser_menu_new_for_manager
212
(<a href="GtkRecentManager.html" title="GtkRecentManager">GtkRecentManager</a> *manager);</pre>
214
Creates a new <a href="GtkRecentChooserMenu.html" title="GtkRecentChooserMenu"><span class="type">GtkRecentChooserMenu</span></a> widget using <em class="parameter"><code>manager</code></em> as
215
the underlying recently used resources manager.
218
This is useful if you have implemented your own recent manager,
219
or if you have a customized instance of a <a href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>
220
object or if you wish to share a common <a href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> object
221
among multiple <a href="GtkRecentChooser.html" title="GtkRecentChooser"><span class="type">GtkRecentChooser</span></a> widgets.</p>
225
<div class="variablelist"><table border="0">
226
<col align="left" valign="top">
229
<td><span class="term"><em class="parameter"><code>manager</code></em> :</span></td>
230
<td> a <a href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>
234
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
235
<td> a new <a href="GtkRecentChooserMenu.html" title="GtkRecentChooserMenu"><span class="type">GtkRecentChooserMenu</span></a>, bound to <em class="parameter"><code>manager</code></em>.
241
<p class="since">Since 2.10
245
<div class="refsect2" lang="en">
246
<a name="id3864860"></a><h3>
247
<a name="gtk-recent-chooser-menu-get-show-numbers"></a>gtk_recent_chooser_menu_get_show_numbers ()</h3>
248
<a class="indexterm" name="id3864877"></a><pre class="programlisting">gboolean gtk_recent_chooser_menu_get_show_numbers
249
(<a href="GtkRecentChooserMenu.html" title="GtkRecentChooserMenu">GtkRecentChooserMenu</a> *menu);</pre>
251
Returns the value set by <a href="GtkRecentChooserMenu.html#gtk-recent-chooser-menu-set-show-numbers"><code class="function">gtk_recent_chooser_menu_set_show_numbers()</code></a>.</p>
255
<div class="variablelist"><table border="0">
256
<col align="left" valign="top">
259
<td><span class="term"><em class="parameter"><code>menu</code></em> :</span></td>
260
<td> a <a href="GtkRecentChooserMenu.html" title="GtkRecentChooserMenu"><span class="type">GtkRecentChooserMenu</span></a>
264
<td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
265
<td> <code class="literal">TRUE</code> if numbers should be shown.
271
<p class="since">Since 2.10
275
<div class="refsect2" lang="en">
276
<a name="id3864977"></a><h3>
277
<a name="gtk-recent-chooser-menu-set-show-numbers"></a>gtk_recent_chooser_menu_set_show_numbers ()</h3>
278
<a class="indexterm" name="id3864993"></a><pre class="programlisting">void gtk_recent_chooser_menu_set_show_numbers
279
(<a href="GtkRecentChooserMenu.html" title="GtkRecentChooserMenu">GtkRecentChooserMenu</a> *menu,
280
gboolean show_numbers);</pre>
282
Sets whether a number should be added to the items of <em class="parameter"><code>menu</code></em>. The
283
numbers are shown to provide a unique character for a mnemonic to
284
be used inside ten menu item's label. Only the first the items
285
get a number to avoid clashes.</p>
289
<div class="variablelist"><table border="0">
290
<col align="left" valign="top">
293
<td><span class="term"><em class="parameter"><code>menu</code></em> :</span></td>
294
<td> a <a href="GtkRecentChooserMenu.html" title="GtkRecentChooserMenu"><span class="type">GtkRecentChooserMenu</span></a>
298
<td><span class="term"><em class="parameter"><code>show_numbers</code></em> :</span></td>
299
<td> whether to show numbers
304
<p class="since">Since 2.10
308
<div class="refsect1" lang="en">
309
<a name="id3865093"></a><h2>Property Details</h2>
310
<div class="refsect2" lang="en">
311
<a name="id3865104"></a><h3>
312
<a name="GtkRecentChooserMenu--show-numbers"></a>The "<code class="literal">show-numbers</code>" property</h3>
313
<a class="indexterm" name="id3865121"></a><pre class="programlisting"> "show-numbers" gboolean : Read / Write</pre>
315
Whether the first ten items in the menu should be prepended by
316
a number acting as a unique mnemonic.</p>
320
<p>Default value: FALSE</p>
325
<div class="refsect1" lang="en">
326
<a name="id3865159"></a><h2>See Also</h2>
328
<a href="GtkRecentChooser.html" title="GtkRecentChooser"><span class="type">GtkRecentChooser</span></a>