← 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/GtkRecentChooserDialog.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/GtkRecentChooserDialog.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>GtkRecentChooserDialog</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="GtkRecentChooser.html" title="GtkRecentChooser">
 
10
<link rel="next" href="GtkRecentChooserMenu.html" title="GtkRecentChooserMenu">
 
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="GtkRecentChooser.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="GtkRecentChooserMenu.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="#GtkRecentChooserDialog.synopsis" class="shortcut">Top</a>
 
25
                   | 
 
26
                  <a href="#GtkRecentChooserDialog.description" class="shortcut">Description</a>
 
27
                   | 
 
28
                  <a href="#GtkRecentChooserDialog.object-hierarchy" class="shortcut">Object Hierarchy</a>
 
29
                   | 
 
30
                  <a href="#GtkRecentChooserDialog.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
 
31
</td></tr>
 
32
</table>
 
33
<div class="refentry">
 
34
<a name="GtkRecentChooserDialog"></a><div class="titlepage"></div>
 
35
<div class="refnamediv"><table width="100%"><tr>
 
36
<td valign="top">
 
37
<h2><span class="refentrytitle"><a name="GtkRecentChooserDialog.top_of_page"></a>GtkRecentChooserDialog</span></h2>
 
38
<p>GtkRecentChooserDialog — Displays recently used files in a dialog</p>
 
39
</td>
 
40
<td valign="top" align="right"><img src="recentchooserdialog.png"></td>
 
41
</tr></table></div>
 
42
<div class="refsynopsisdiv">
 
43
<a name="GtkRecentChooserDialog.synopsis"></a><h2>Synopsis</h2>
 
44
<pre class="synopsis">
 
45
#include &lt;gtk/gtk.h&gt;
 
46
 
 
47
struct              <a class="link" href="GtkRecentChooserDialog.html#GtkRecentChooserDialog-struct" title="struct GtkRecentChooserDialog">GtkRecentChooserDialog</a>;
 
48
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkRecentChooserDialog.html#gtk-recent-chooser-dialog-new" title="gtk_recent_chooser_dialog_new ()">gtk_recent_chooser_dialog_new</a>       (<em class="parameter"><code>const <span class="type">gchar</span> *title</code></em>,
 
49
                                                         <em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *parent</code></em>,
 
50
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *first_button_text</code></em>,
 
51
                                                         <em class="parameter"><code>...</code></em>);
 
52
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkRecentChooserDialog.html#gtk-recent-chooser-dialog-new-for-manager" title="gtk_recent_chooser_dialog_new_for_manager ()">gtk_recent_chooser_dialog_new_for_manager</a>
 
53
                                                        (<em class="parameter"><code>const <span class="type">gchar</span> *title</code></em>,
 
54
                                                         <em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *parent</code></em>,
 
55
                                                         <em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
 
56
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *first_button_text</code></em>,
 
57
                                                         <em class="parameter"><code>...</code></em>);
 
58
</pre>
 
59
</div>
 
60
<div class="refsect1">
 
61
<a name="GtkRecentChooserDialog.object-hierarchy"></a><h2>Object Hierarchy</h2>
 
62
<pre class="synopsis">
 
63
  GObject
 
64
   +----GInitiallyUnowned
 
65
         +----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
 
66
               +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
 
67
                     +----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
 
68
                           +----<a class="link" href="GtkBin.html" title="GtkBin">GtkBin</a>
 
69
                                 +----<a class="link" href="GtkWindow.html" title="GtkWindow">GtkWindow</a>
 
70
                                       +----<a class="link" href="GtkDialog.html" title="GtkDialog">GtkDialog</a>
 
71
                                             +----GtkRecentChooserDialog
 
72
</pre>
 
73
</div>
 
74
<div class="refsect1">
 
75
<a name="GtkRecentChooserDialog.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
 
76
<p>
 
77
GtkRecentChooserDialog implements
 
78
 AtkImplementorIface,  <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a> and  <a class="link" href="GtkRecentChooser.html" title="GtkRecentChooser">GtkRecentChooser</a>.</p>
 
79
</div>
 
80
<div class="refsect1">
 
81
<a name="GtkRecentChooserDialog.description"></a><h2>Description</h2>
 
82
<p>
 
83
<a class="link" href="GtkRecentChooserDialog.html" title="GtkRecentChooserDialog"><span class="type">GtkRecentChooserDialog</span></a> is a dialog box suitable for displaying the recently
 
84
used documents.  This widgets works by putting a <a class="link" href="GtkRecentChooserWidget.html" title="GtkRecentChooserWidget"><span class="type">GtkRecentChooserWidget</span></a> inside
 
85
a <a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a>.  It exposes the <a class="link" href="GtkRecentChooser.html#GtkRecentChooserIface" title="struct GtkRecentChooserIface"><span class="type">GtkRecentChooserIface</span></a> interface, so you can use
 
86
all the <a class="link" href="GtkRecentChooser.html" title="GtkRecentChooser"><span class="type">GtkRecentChooser</span></a> functions on the recent chooser dialog as well as
 
87
those for <a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a>.
 
88
</p>
 
89
<p>
 
90
Note that <a class="link" href="GtkRecentChooserDialog.html" title="GtkRecentChooserDialog"><span class="type">GtkRecentChooserDialog</span></a> does not have any methods of its own.
 
91
Instead, you should use the functions that work on a <a class="link" href="GtkRecentChooser.html" title="GtkRecentChooser"><span class="type">GtkRecentChooser</span></a>.
 
92
</p>
 
93
<div class="example">
 
94
<a name="gtkrecentchooser-typical-usage"></a><p class="title"><b>Example 60. Typical usage</b></p>
 
95
<div class="example-contents">
 
96
<p>
 
97
    In the simplest of cases, you can use the following code to use
 
98
    a <a class="link" href="GtkRecentChooserDialog.html" title="GtkRecentChooserDialog"><span class="type">GtkRecentChooserDialog</span></a> to select a recently used file:
 
99
  </p>
 
100
<pre class="programlisting">
 
101
GtkWidget *dialog;
 
102
dialog = gtk_recent_chooser_dialog_new ("Recent Documents",
 
103
                                        parent_window,
 
104
                                        GTK_STOCK_CANCEL, GTK_RESPONSE_CANCEL,
 
105
                                        GTK_STOCK_OPEN, GTK_RESPONSE_ACCEPT,
 
106
                                        NULL);
 
107
if (gtk_dialog_run (GTK_DIALOG (dialog)) == GTK_RESPONSE_ACCEPT)
 
108
  {
 
109
    GtkRecentInfo *info;
 
110
    info = gtk_recent_chooser_get_current_item (GTK_RECENT_CHOOSER (dialog));
 
111
    open_file (gtk_recent_info_get_uri (info));
 
112
    gtk_recent_info_unref (info);
 
113
  }
 
114
gtk_widget_destroy (dialog);
 
115
  </pre>
 
116
</div>
 
117
</div>
 
118
<br class="example-break"><p>
 
119
Recently used files are supported since GTK+ 2.10.
 
120
</p>
 
121
</div>
 
122
<div class="refsect1">
 
123
<a name="GtkRecentChooserDialog.details"></a><h2>Details</h2>
 
124
<div class="refsect2">
 
125
<a name="GtkRecentChooserDialog-struct"></a><h3>struct GtkRecentChooserDialog</h3>
 
126
<pre class="programlisting">struct GtkRecentChooserDialog;</pre>
 
127
<p>
 
128
</p>
 
129
</div>
 
130
<hr>
 
131
<div class="refsect2">
 
132
<a name="gtk-recent-chooser-dialog-new"></a><h3>gtk_recent_chooser_dialog_new ()</h3>
 
133
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_recent_chooser_dialog_new       (<em class="parameter"><code>const <span class="type">gchar</span> *title</code></em>,
 
134
                                                         <em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *parent</code></em>,
 
135
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *first_button_text</code></em>,
 
136
                                                         <em class="parameter"><code>...</code></em>);</pre>
 
137
<p>
 
138
Creates a new <a class="link" href="GtkRecentChooserDialog.html" title="GtkRecentChooserDialog"><span class="type">GtkRecentChooserDialog</span></a>.  This function is analogous to
 
139
<a class="link" href="GtkDialog.html#gtk-dialog-new-with-buttons" title="gtk_dialog_new_with_buttons ()"><code class="function">gtk_dialog_new_with_buttons()</code></a>.
 
140
</p>
 
141
<div class="variablelist"><table border="0" class="variablelist">
 
142
<colgroup>
 
143
<col align="left" valign="top">
 
144
<col>
 
145
</colgroup>
 
146
<tbody>
 
147
<tr>
 
148
<td><p><span class="term"><em class="parameter"><code>title</code></em> :</span></p></td>
 
149
<td>Title of the dialog, 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>
 
150
</td>
 
151
</tr>
 
152
<tr>
 
153
<td><p><span class="term"><em class="parameter"><code>parent</code></em> :</span></p></td>
 
154
<td>Transient parent of the dialog, 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>
 
155
</td>
 
156
</tr>
 
157
<tr>
 
158
<td><p><span class="term"><em class="parameter"><code>first_button_text</code></em> :</span></p></td>
 
159
<td>stock ID or text to go in the first button, 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>
 
160
</td>
 
161
</tr>
 
162
<tr>
 
163
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
164
<td>a new <a class="link" href="GtkRecentChooserDialog.html" title="GtkRecentChooserDialog"><span class="type">GtkRecentChooserDialog</span></a>
 
165
</td>
 
166
</tr>
 
167
</tbody>
 
168
</table></div>
 
169
<p class="since">Since 2.10</p>
 
170
</div>
 
171
<hr>
 
172
<div class="refsect2">
 
173
<a name="gtk-recent-chooser-dialog-new-for-manager"></a><h3>gtk_recent_chooser_dialog_new_for_manager ()</h3>
 
174
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_recent_chooser_dialog_new_for_manager
 
175
                                                        (<em class="parameter"><code>const <span class="type">gchar</span> *title</code></em>,
 
176
                                                         <em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *parent</code></em>,
 
177
                                                         <em class="parameter"><code><a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> *manager</code></em>,
 
178
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *first_button_text</code></em>,
 
179
                                                         <em class="parameter"><code>...</code></em>);</pre>
 
180
<p>
 
181
Creates a new <a class="link" href="GtkRecentChooserDialog.html" title="GtkRecentChooserDialog"><span class="type">GtkRecentChooserDialog</span></a> with a specified recent manager.
 
182
</p>
 
183
<p>
 
184
This is useful if you have implemented your own recent manager, or if you
 
185
have a customized instance of a <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a> object.
 
186
</p>
 
187
<div class="variablelist"><table border="0" class="variablelist">
 
188
<colgroup>
 
189
<col align="left" valign="top">
 
190
<col>
 
191
</colgroup>
 
192
<tbody>
 
193
<tr>
 
194
<td><p><span class="term"><em class="parameter"><code>title</code></em> :</span></p></td>
 
195
<td>Title of the dialog, 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>
 
196
</td>
 
197
</tr>
 
198
<tr>
 
199
<td><p><span class="term"><em class="parameter"><code>parent</code></em> :</span></p></td>
 
200
<td>Transient parent of the dialog, 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>
 
201
</td>
 
202
</tr>
 
203
<tr>
 
204
<td><p><span class="term"><em class="parameter"><code>manager</code></em> :</span></p></td>
 
205
<td>a <a class="link" href="GtkRecentManager.html" title="GtkRecentManager"><span class="type">GtkRecentManager</span></a>
 
206
</td>
 
207
</tr>
 
208
<tr>
 
209
<td><p><span class="term"><em class="parameter"><code>first_button_text</code></em> :</span></p></td>
 
210
<td>stock ID or text to go in the first button, 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>
 
211
</td>
 
212
</tr>
 
213
<tr>
 
214
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 
215
<td>a new <a class="link" href="GtkRecentChooserDialog.html" title="GtkRecentChooserDialog"><span class="type">GtkRecentChooserDialog</span></a>
 
216
</td>
 
217
</tr>
 
218
</tbody>
 
219
</table></div>
 
220
<p class="since">Since 2.10</p>
 
221
</div>
 
222
</div>
 
223
<div class="refsect1">
 
224
<a name="GtkRecentChooserDialog.see-also"></a><h2>See Also</h2>
 
225
<p>
 
226
<a class="link" href="GtkRecentChooser.html" title="GtkRecentChooser"><span class="type">GtkRecentChooser</span></a>, <a class="link" href="GtkDialog.html" title="GtkDialog"><span class="type">GtkDialog</span></a>
 
227
</p>
 
228
</div>
 
229
</div>
 
230
<div class="footer">
 
231
<hr>
 
232
          Generated by GTK-Doc V1.18</div>
 
233
</body>
 
234
</html>
 
 
b'\\ No newline at end of file'