← Back to branch summary

~canonical-dx-team/ubuntu/maverick/gtk+2.0/menuproxy

« back to all changes in this revision

Viewing changes to docs/reference/gtk/html/GtkFileSelection.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastian Dröge
  • Date: 2010-06-11 12:19:30 UTC
  • mfrom: (1.11.6 upstream)
  • mto: This revision was merged to the branch mainline in revision 175.
  • Revision ID: james.westby@ubuntu.com-20100611121930-n4pklvkoqdsg12vm
Tags: 2.21.2-1
* New upstream development release:
  + debian/rules,
    debian/libgtk2.0-0.symbols:
    - Update for new API symbols.
  + debian/patches/070_mandatory-relibtoolize.patch:
    - Regenerated for the new version.
  + debian/control.in:
    - Update GLib (build-) dependency to >= 2.25.8.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/html/GtkFileSelection.html
47
47
#include <gtk/gtk.h>
48
48
 
49
49
                    <a class="link" href="GtkFileSelection.html#GtkFileSelection-struct" title="GtkFileSelection">GtkFileSelection</a>;
50
 
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a>*          <a class="link" href="GtkFileSelection.html#gtk-file-selection-new" title="gtk_file_selection_new ()">gtk_file_selection_new</a>              (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>);
 
50
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a>*          <a class="link" href="GtkFileSelection.html#gtk-file-selection-new" title="gtk_file_selection_new ()">gtk_file_selection_new</a>              (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>);
51
51
<span class="returnvalue">void</span>                <a class="link" href="GtkFileSelection.html#gtk-file-selection-set-filename" title="gtk_file_selection_set_filename ()">gtk_file_selection_set_filename</a>     (<em class="parameter"><code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a> *filesel</code></em>,
52
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>);
53
 
const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*        <a class="link" href="GtkFileSelection.html#gtk-file-selection-get-filename" title="gtk_file_selection_get_filename ()">gtk_file_selection_get_filename</a>     (<em class="parameter"><code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a> *filesel</code></em>);
 
52
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>);
 
53
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*        <a class="link" href="GtkFileSelection.html#gtk-file-selection-get-filename" title="gtk_file_selection_get_filename ()">gtk_file_selection_get_filename</a>     (<em class="parameter"><code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a> *filesel</code></em>);
54
54
<span class="returnvalue">void</span>                <a class="link" href="GtkFileSelection.html#gtk-file-selection-complete" title="gtk_file_selection_complete ()">gtk_file_selection_complete</a>         (<em class="parameter"><code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a> *filesel</code></em>,
55
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *pattern</code></em>);
 
55
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *pattern</code></em>);
56
56
<span class="returnvalue">void</span>                <a class="link" href="GtkFileSelection.html#gtk-file-selection-show-fileop-buttons" title="gtk_file_selection_show_fileop_buttons ()">gtk_file_selection_show_fileop_buttons</a>
57
57
                                                        (<em class="parameter"><code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a> *filesel</code></em>);
58
58
<span class="returnvalue">void</span>                <a class="link" href="GtkFileSelection.html#gtk-file-selection-hide-fileop-buttons" title="gtk_file_selection_hide_fileop_buttons ()">gtk_file_selection_hide_fileop_buttons</a>
59
59
                                                        (<em class="parameter"><code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a> *filesel</code></em>);
60
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>**             <a class="link" href="GtkFileSelection.html#gtk-file-selection-get-selections" title="gtk_file_selection_get_selections ()">gtk_file_selection_get_selections</a>   (<em class="parameter"><code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a> *filesel</code></em>);
 
60
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>**             <a class="link" href="GtkFileSelection.html#gtk-file-selection-get-selections" title="gtk_file_selection_get_selections ()">gtk_file_selection_get_selections</a>   (<em class="parameter"><code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a> *filesel</code></em>);
61
61
<span class="returnvalue">void</span>                <a class="link" href="GtkFileSelection.html#gtk-file-selection-set-select-multiple" title="gtk_file_selection_set_select_multiple ()">gtk_file_selection_set_select_multiple</a>
62
62
                                                        (<em class="parameter"><code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a> *filesel</code></em>,
63
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> select_multiple</code></em>);
64
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkFileSelection.html#gtk-file-selection-get-select-multiple" title="gtk_file_selection_get_select_multiple ()">gtk_file_selection_get_select_multiple</a>
 
63
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> select_multiple</code></em>);
 
64
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkFileSelection.html#gtk-file-selection-get-select-multiple" title="gtk_file_selection_get_select_multiple ()">gtk_file_selection_get_select_multiple</a>
65
65
                                                        (<em class="parameter"><code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a> *filesel</code></em>);
66
66
</pre>
67
67
</div>
68
68
<div class="refsect1" title="Object Hierarchy">
69
69
<a name="GtkFileSelection.object-hierarchy"></a><h2>Object Hierarchy</h2>
70
70
<pre class="synopsis">
71
 
  <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>
72
 
   +----<a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
 
71
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
 
72
   +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
73
73
         +----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
74
74
               +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
75
75
                     +----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
88
88
<div class="refsect1" title="Properties">
89
89
<a name="GtkFileSelection.properties"></a><h2>Properties</h2>
90
90
<pre class="synopsis">
91
 
  "<a class="link" href="GtkFileSelection.html#GtkFileSelection--filename" title='The "filename" property'>filename</a>"                 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
92
 
  "<a class="link" href="GtkFileSelection.html#GtkFileSelection--select-multiple" title='The "select-multiple" property'>select-multiple</a>"          <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
93
 
  "<a class="link" href="GtkFileSelection.html#GtkFileSelection--show-fileops" title='The "show-fileops" property'>show-fileops</a>"             <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
91
  "<a class="link" href="GtkFileSelection.html#GtkFileSelection--filename" title='The "filename" property'>filename</a>"                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
 
92
  "<a class="link" href="GtkFileSelection.html#GtkFileSelection--select-multiple" title='The "select-multiple" property'>select-multiple</a>"          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
93
  "<a class="link" href="GtkFileSelection.html#GtkFileSelection--show-fileops" title='The "show-fileops" property'>show-fileops</a>"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
94
94
</pre>
95
95
</div>
96
96
<div class="refsect1" title="Description">
124
124
<p>
125
125
</p>
126
126
<div class="example">
127
 
<a name="id1486453"></a><p class="title"><b>Example 61. Getting a filename from the user.</b></p>
 
127
<a name="id1248333"></a><p class="title"><b>Example 61. Getting a filename from the user.</b></p>
128
128
<div class="example-contents">
129
129
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
130
130
    <tbody>
157
157
26
158
158
27</pre></td>
159
159
        <td class="listing_code"><pre class="programlisting"><span class="comment">/* The file selection widget and the string to store the chosen filename */</span>
160
 
<span class="type">void</span><span class="normal"> </span><span class="function">store_filename</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="GtkWidget.html">GtkWidget</a> </span><span class="symbol">*</span><span class="normal">widget</span><span class="symbol">,</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</span><span class="symbol">)</span><span class="normal"> </span><span class="cbracket">{</span>
161
 
<span class="normal">   <a href="GtkWidget.html">GtkWidget</a> </span><span class="symbol">*</span><span class="normal">file_selector </span><span class="symbol">=</span><span class="normal"> </span><span class="function">GTK_WIDGET</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">user_data</span><span class="symbol">);</span>
162
 
<span class="normal">   </span><span class="keyword">const</span><span class="normal"> <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> </span><span class="symbol">*</span><span class="normal">selected_filename</span><span class="symbol">;</span>
 
160
<span class="type">void</span><span class="normal"> </span><span class="function">store_filename</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">widget</span><span class="symbol">,</span><span class="normal"> </span><span class="usertype">gpointer</span><span class="normal"> user_data</span><span class="symbol">)</span><span class="normal"> </span><span class="cbracket">{</span>
 
161
<span class="normal">   </span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">file_selector </span><span class="symbol">=</span><span class="normal"> </span><span class="function">GTK_WIDGET</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">user_data</span><span class="symbol">);</span>
 
162
<span class="normal">   </span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">selected_filename</span><span class="symbol">;</span>
163
163
<span class="normal">   selected_filename </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkFileSelection.html#gtk-file-selection-get-filename">gtk_file_selection_get_filename</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_FILE_SELECTION</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">file_selector</span><span class="symbol">));</span>
164
 
<span class="normal">   </span><span class="function"><a href="/usr/share/gtk-doc/html/glib/glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Selected filename: %s</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span><span class="normal"> selected_filename</span><span class="symbol">);</span>
 
164
<span class="normal">   </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Warnings-and-Assertions.html#g-print">g_print</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Selected filename: %s</span><span class="specialchar">\n</span><span class="string">"</span><span class="symbol">,</span><span class="normal"> selected_filename</span><span class="symbol">);</span>
165
165
<span class="cbracket">}</span>
166
166
<span class="type">void</span><span class="normal"> </span><span class="function">create_file_selection</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span><span class="normal"> </span><span class="cbracket">{</span>
167
 
<span class="normal">   <a href="GtkWidget.html">GtkWidget</a> </span><span class="symbol">*</span><span class="normal">file_selector</span><span class="symbol">;</span>
 
167
<span class="normal">   </span><span class="usertype">GtkWidget</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">file_selector</span><span class="symbol">;</span>
168
168
<span class="normal">   </span><span class="comment">/* Create the selector */</span>
169
169
<span class="normal">   file_selector </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkFileSelection.html#gtk-file-selection-new">gtk_file_selection_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Please select a file for editing."</span><span class="symbol">);</span>
170
 
<span class="normal">   </span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_FILE_SELECTION</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">file_selector</span><span class="symbol">)-&gt;</span><span class="normal">ok_button</span><span class="symbol">,</span>
 
170
<span class="normal">   </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_FILE_SELECTION</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">file_selector</span><span class="symbol">)-&gt;</span><span class="normal">ok_button</span><span class="symbol">,</span>
171
171
<span class="normal">                     </span><span class="string">"clicked"</span><span class="symbol">,</span>
172
 
<span class="normal">                     </span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">store_filename</span><span class="symbol">),</span>
 
172
<span class="normal">                     </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">store_filename</span><span class="symbol">),</span>
173
173
<span class="normal">                     file_selector</span><span class="symbol">);</span>
174
174
<span class="normal">   </span><span class="comment">/* Ensure that the dialog box is destroyed when the user clicks a button. */</span>
175
 
<span class="normal">   </span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect-swapped">g_signal_connect_swapped</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_FILE_SELECTION</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">file_selector</span><span class="symbol">)-&gt;</span><span class="normal">ok_button</span><span class="symbol">,</span>
 
175
<span class="normal">   </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect-swapped">g_signal_connect_swapped</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_FILE_SELECTION</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">file_selector</span><span class="symbol">)-&gt;</span><span class="normal">ok_button</span><span class="symbol">,</span>
176
176
<span class="normal">                             </span><span class="string">"clicked"</span><span class="symbol">,</span>
177
 
<span class="normal">                             </span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="GtkWidget.html#gtk-widget-destroy">gtk_widget_destroy</a></span><span class="symbol">),</span>
 
177
<span class="normal">                             </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="GtkWidget.html#gtk-widget-destroy">gtk_widget_destroy</a></span><span class="symbol">),</span>
178
178
<span class="normal">                             file_selector</span><span class="symbol">);</span>
179
 
<span class="normal">   </span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-Signals.html#g-signal-connect-swapped">g_signal_connect_swapped</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_FILE_SELECTION</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">file_selector</span><span class="symbol">)-&gt;</span><span class="normal">cancel_button</span><span class="symbol">,</span>
 
179
<span class="normal">   </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect-swapped">g_signal_connect_swapped</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_FILE_SELECTION</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">file_selector</span><span class="symbol">)-&gt;</span><span class="normal">cancel_button</span><span class="symbol">,</span>
180
180
<span class="normal">                             </span><span class="string">"clicked"</span><span class="symbol">,</span>
181
 
<span class="normal">                             </span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="GtkWidget.html#gtk-widget-destroy">gtk_widget_destroy</a></span><span class="symbol">),</span>
 
181
<span class="normal">                             </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="GtkWidget.html#gtk-widget-destroy">gtk_widget_destroy</a></span><span class="symbol">),</span>
182
182
<span class="normal">                             file_selector</span><span class="symbol">);</span>
183
183
<span class="normal">   </span><span class="comment">/* Display that dialog */</span>
184
184
<span class="normal">   </span><span class="function"><a href="GtkWidget.html#gtk-widget-show">gtk_widget_show</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">file_selector</span><span class="symbol">);</span>
285
285
</td>
286
286
</tr>
287
287
<tr>
288
 
<td><p><span class="term"><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *<em class="structfield"><code><a name="GtkFileSelection-struct.history-list"></a>history_list</code></em>;</span></p></td>
 
288
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *<em class="structfield"><code><a name="GtkFileSelection-struct.history-list"></a>history_list</code></em>;</span></p></td>
289
289
<td>
290
290
</td>
291
291
</tr>
302
302
</td>
303
303
</tr>
304
304
<tr>
305
 
<td><p><span class="term"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GtkFileSelection-struct.fileop-file"></a>fileop_file</code></em>;</span></p></td>
 
305
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="GtkFileSelection-struct.fileop-file"></a>fileop_file</code></em>;</span></p></td>
306
306
<td>
307
307
</td>
308
308
</tr>
309
309
<tr>
310
 
<td><p><span class="term"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> <em class="structfield"><code><a name="GtkFileSelection-struct.cmpl-state"></a>cmpl_state</code></em>;</span></p></td>
 
310
<td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> <em class="structfield"><code><a name="GtkFileSelection-struct.cmpl-state"></a>cmpl_state</code></em>;</span></p></td>
311
311
<td>
312
312
</td>
313
313
</tr>
345
345
<hr>
346
346
<div class="refsect2" title="gtk_file_selection_new ()">
347
347
<a name="gtk-file-selection-new"></a><h3>gtk_file_selection_new ()</h3>
348
 
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a>*          gtk_file_selection_new              (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>);</pre>
 
348
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a>*          gtk_file_selection_new              (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>);</pre>
349
349
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
350
350
<h3 class="title">Warning</h3>
351
351
<p><code class="literal">gtk_file_selection_new</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="GtkFileChooserDialog.html#gtk-file-chooser-dialog-new" title="gtk_file_chooser_dialog_new ()"><code class="function">gtk_file_chooser_dialog_new()</code></a> instead</p>
373
373
<div class="refsect2" title="gtk_file_selection_set_filename ()">
374
374
<a name="gtk-file-selection-set-filename"></a><h3>gtk_file_selection_set_filename ()</h3>
375
375
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_file_selection_set_filename     (<em class="parameter"><code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a> *filesel</code></em>,
376
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>);</pre>
 
376
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>);</pre>
377
377
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
378
378
<h3 class="title">Warning</h3>
379
379
<p><code class="literal">gtk_file_selection_set_filename</code> is deprecated and should not be used in newly-written code.</p>
390
390
</p>
391
391
<p>
392
392
The encoding of <em class="parameter"><code>filename</code></em> is preferred GLib file name encoding, which
393
 
may not be UTF-8. See <a href="/usr/share/gtk-doc/html/glib/glib-Character-Set-Conversion.html#g-filename-from-utf8"><code class="function">g_filename_from_utf8()</code></a>.
 
393
may not be UTF-8. See <a href="http://library.gnome.org/devel/glib/unstable/glib-Character-Set-Conversion.html#g-filename-from-utf8"><code class="function">g_filename_from_utf8()</code></a>.
394
394
</p>
395
395
<div class="variablelist"><table border="0">
396
396
<col align="left" valign="top">
411
411
<hr>
412
412
<div class="refsect2" title="gtk_file_selection_get_filename ()">
413
413
<a name="gtk-file-selection-get-filename"></a><h3>gtk_file_selection_get_filename ()</h3>
414
 
<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*        gtk_file_selection_get_filename     (<em class="parameter"><code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a> *filesel</code></em>);</pre>
 
414
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*        gtk_file_selection_get_filename     (<em class="parameter"><code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a> *filesel</code></em>);</pre>
415
415
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
416
416
<h3 class="title">Warning</h3>
417
417
<p><code class="literal">gtk_file_selection_get_filename</code> is deprecated and should not be used in newly-written code.</p>
418
418
</div>
419
419
<p>
420
420
This function returns the selected filename in the GLib file name
421
 
encoding. To convert to UTF-8, call <a href="/usr/share/gtk-doc/html/glib/glib-Character-Set-Conversion.html#g-filename-to-utf8"><code class="function">g_filename_to_utf8()</code></a>. The
 
421
encoding. To convert to UTF-8, call <a href="http://library.gnome.org/devel/glib/unstable/glib-Character-Set-Conversion.html#g-filename-to-utf8"><code class="function">g_filename_to_utf8()</code></a>. The
422
422
returned string points to a statically allocated buffer and should
423
423
be copied if you plan to keep it around.
424
424
</p>
445
445
<div class="refsect2" title="gtk_file_selection_complete ()">
446
446
<a name="gtk-file-selection-complete"></a><h3>gtk_file_selection_complete ()</h3>
447
447
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_file_selection_complete         (<em class="parameter"><code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a> *filesel</code></em>,
448
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *pattern</code></em>);</pre>
 
448
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *pattern</code></em>);</pre>
449
449
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
450
450
<h3 class="title">Warning</h3>
451
451
<p><code class="literal">gtk_file_selection_complete</code> is deprecated and should not be used in newly-written code.</p>
517
517
<hr>
518
518
<div class="refsect2" title="gtk_file_selection_get_selections ()">
519
519
<a name="gtk-file-selection-get-selections"></a><h3>gtk_file_selection_get_selections ()</h3>
520
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>**             gtk_file_selection_get_selections   (<em class="parameter"><code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a> *filesel</code></em>);</pre>
 
520
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>**             gtk_file_selection_get_selections   (<em class="parameter"><code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a> *filesel</code></em>);</pre>
521
521
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
522
522
<h3 class="title">Warning</h3>
523
523
<p><code class="literal">gtk_file_selection_get_selections</code> is deprecated and should not be used in newly-written code.</p>
529
529
</p>
530
530
<p>
531
531
The filenames are in the GLib file name encoding. To convert to
532
 
UTF-8, call <a href="/usr/share/gtk-doc/html/glib/glib-Character-Set-Conversion.html#g-filename-to-utf8"><code class="function">g_filename_to_utf8()</code></a> on each string.
 
532
UTF-8, call <a href="http://library.gnome.org/devel/glib/unstable/glib-Character-Set-Conversion.html#g-filename-to-utf8"><code class="function">g_filename_to_utf8()</code></a> on each string.
533
533
</p>
534
534
<div class="variablelist"><table border="0">
535
535
<col align="left" valign="top">
541
541
</tr>
542
542
<tr>
543
543
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
544
 
<td> a newly-allocated <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of strings. Use
545
 
<a href="/usr/share/gtk-doc/html/glib/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a> to free it.
 
544
<td> a newly-allocated <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of strings. Use
 
545
<a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a> to free it.
546
546
</td>
547
547
</tr>
548
548
</tbody>
553
553
<a name="gtk-file-selection-set-select-multiple"></a><h3>gtk_file_selection_set_select_multiple ()</h3>
554
554
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_file_selection_set_select_multiple
555
555
                                                        (<em class="parameter"><code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a> *filesel</code></em>,
556
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> select_multiple</code></em>);</pre>
 
556
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> select_multiple</code></em>);</pre>
557
557
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
558
558
<h3 class="title">Warning</h3>
559
559
<p><code class="literal">gtk_file_selection_set_select_multiple</code> is deprecated and should not be used in newly-written code.</p>
582
582
<hr>
583
583
<div class="refsect2" title="gtk_file_selection_get_select_multiple ()">
584
584
<a name="gtk-file-selection-get-select-multiple"></a><h3>gtk_file_selection_get_select_multiple ()</h3>
585
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_file_selection_get_select_multiple
 
585
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_file_selection_get_select_multiple
586
586
                                                        (<em class="parameter"><code><a class="link" href="GtkFileSelection.html" title="GtkFileSelection"><span class="type">GtkFileSelection</span></a> *filesel</code></em>);</pre>
587
587
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
588
588
<h3 class="title">Warning</h3>
602
602
</tr>
603
603
<tr>
604
604
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
605
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the user is allowed to select multiple files in the
 
605
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the user is allowed to select multiple files in the
606
606
file list
607
607
</td>
608
608
</tr>
614
614
<a name="GtkFileSelection.property-details"></a><h2>Property Details</h2>
615
615
<div class="refsect2" title='The "filename" property'>
616
616
<a name="GtkFileSelection--filename"></a><h3>The <code class="literal">"filename"</code> property</h3>
617
 
<pre class="programlisting">  "filename"                 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
 
617
<pre class="programlisting">  "filename"                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
618
618
<p>The currently selected filename.</p>
619
619
<p>Default value: NULL</p>
620
620
</div>
621
621
<hr>
622
622
<div class="refsect2" title='The "select-multiple" property'>
623
623
<a name="GtkFileSelection--select-multiple"></a><h3>The <code class="literal">"select-multiple"</code> property</h3>
624
 
<pre class="programlisting">  "select-multiple"          <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
624
<pre class="programlisting">  "select-multiple"          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
625
625
<p>Whether to allow multiple files to be selected.</p>
626
626
<p>Default value: FALSE</p>
627
627
</div>
628
628
<hr>
629
629
<div class="refsect2" title='The "show-fileops" property'>
630
630
<a name="GtkFileSelection--show-fileops"></a><h3>The <code class="literal">"show-fileops"</code> property</h3>
631
 
<pre class="programlisting">  "show-fileops"             <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 
631
<pre class="programlisting">  "show-fileops"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
632
632
<p>Whether buttons for creating/manipulating files should be displayed.</p>
633
633
<p>Default value: TRUE</p>
634
634
</div>