1
<refentry id="GtkRecentChooserWidget">
3
<refentrytitle role="top_of_page">GtkRecentChooserWidget</refentrytitle>
4
<manvolnum>3</manvolnum>
5
<refmiscinfo>GTK Library</refmiscinfo>
9
<refname>GtkRecentChooserWidget</refname>
10
<refpurpose>Displays recently used files</refpurpose>
11
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
14
<refsynopsisdiv role="synopsis">
15
<title role="synopsis.title">Synopsis</title>
19
#include <gtk/gtk.h>
22
<link linkend="GtkRecentChooserWidget-struct">GtkRecentChooserWidget</link>;
23
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gtk-recent-chooser-widget-new">gtk_recent_chooser_widget_new</link> (void);
24
<link linkend="GtkWidget">GtkWidget</link>* <link linkend="gtk-recent-chooser-widget-new-for-manager">gtk_recent_chooser_widget_new_for_manager</link>
25
(<link linkend="GtkRecentManager">GtkRecentManager</link> *manager);
31
<refsect1 role="object_hierarchy">
32
<title role="object_hierarchy.title">Object Hierarchy</title>
35
<link linkend="GObject">GObject</link>
36
+----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
37
+----<link linkend="GtkObject">GtkObject</link>
38
+----<link linkend="GtkWidget">GtkWidget</link>
39
+----<link linkend="GtkContainer">GtkContainer</link>
40
+----<link linkend="GtkBox">GtkBox</link>
41
+----<link linkend="GtkVBox">GtkVBox</link>
42
+----GtkRecentChooserWidget
49
<refsect1 role="impl_interfaces">
50
<title role="impl_interfaces.title">Implemented Interfaces</title>
52
GtkRecentChooserWidget implements
53
<link linkend="AtkImplementorIface">AtkImplementorIface</link> and <link linkend="GtkRecentChooser">GtkRecentChooser</link>.</para>
61
<refsect1 role="desc">
62
<title role="desc.title">Description</title>
64
<link linkend="GtkRecentChooserWidget"><type>GtkRecentChooserWidget</type></link> is a widget suitable for selecting recently used
65
files. It is the main building block of a <link linkend="GtkRecentChooserDialog"><type>GtkRecentChooserDialog</type></link>. Most
66
applications will only need to use the latter; you can use
67
<link linkend="GtkRecentChooserWidget"><type>GtkRecentChooserWidget</type></link> as part of a larger window if you have special needs.
71
Note that <link linkend="GtkRecentChooserWidget"><type>GtkRecentChooserWidget</type></link> does not have any methods of its own.
72
Instead, you should use the functions that work on a <link linkend="GtkRecentChooser"><type>GtkRecentChooser</type></link>.
76
Recently used files are supported since GTK+ 2.10.
80
<refsect1 role="details">
81
<title role="details.title">Details</title>
83
<title><anchor id="GtkRecentChooserWidget-struct" role="struct"/>GtkRecentChooserWidget</title>
84
<indexterm><primary>GtkRecentChooserWidget</primary></indexterm><programlisting>typedef struct _GtkRecentChooserWidget GtkRecentChooserWidget;</programlisting>
89
<title><anchor id="gtk-recent-chooser-widget-new" role="function" condition="since:2.10"/>gtk_recent_chooser_widget_new ()</title>
90
<indexterm role="2.10"><primary>gtk_recent_chooser_widget_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gtk_recent_chooser_widget_new (void);</programlisting>
92
Creates a new <link linkend="GtkRecentChooserWidget"><type>GtkRecentChooserWidget</type></link> object. This is an embeddable widget
93
used to access the recently used resources list.</para>
96
</para><variablelist role="params">
97
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a new <link linkend="GtkRecentChooserWidget"><type>GtkRecentChooserWidget</type></link>
99
</simpara></listitem></varlistentry>
100
</variablelist><para role="since">Since 2.10
103
<title><anchor id="gtk-recent-chooser-widget-new-for-manager" role="function" condition="since:2.10"/>gtk_recent_chooser_widget_new_for_manager ()</title>
104
<indexterm role="2.10"><primary>gtk_recent_chooser_widget_new_for_manager</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link>* gtk_recent_chooser_widget_new_for_manager
105
(<link linkend="GtkRecentManager">GtkRecentManager</link> *manager);</programlisting>
107
Creates a new <link linkend="GtkRecentChooserWidget"><type>GtkRecentChooserWidget</type></link> with a specified recent manager.
110
This is useful if you have implemented your own recent manager, or if you
111
have a customized instance of a <link linkend="GtkRecentManager"><type>GtkRecentManager</type></link> object.</para>
114
</para><variablelist role="params">
115
<varlistentry><term><parameter>manager</parameter> :</term>
116
<listitem><simpara> a <link linkend="GtkRecentManager"><type>GtkRecentManager</type></link>
117
</simpara></listitem></varlistentry>
118
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> a new <link linkend="GtkRecentChooserWidget"><type>GtkRecentChooserWidget</type></link>
120
</simpara></listitem></varlistentry>
121
</variablelist><para role="since">Since 2.10
129
<title>See Also</title>
131
<link linkend="GtkRecentChooser"><type>GtkRecentChooser</type></link>, <link linkend="GtkRecentChooserDialog"><type>GtkRecentChooserDialog</type></link>