← Back to branch summary

~ubuntu-branches/ubuntu/raring/gtk+2.0/raring-proposed

« back to all changes in this revision

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

  • Committer: Package Import Robot
  • Author(s): Rico Tzschichholz, Jeremy Bicha, Rico Tzschichholz
  • Date: 2013-02-25 04:48:13 UTC
  • mfrom: (72.1.32 experimental)
  • Revision ID: package-import@ubuntu.com-20130225044813-tuhknnk1l7rq0itt
Tags: 2.24.16-1ubuntu1
https://launchpad.net/bugs/488857
[ Jeremy Bicha ]
* Sync with Debian. Remaining changes:
* debian/libgtk2.0-0.symbols:
  - Add Ubuntu specific symbols
* debian/patches/012_ubuntu-set-grab-add.patch
  - Added ubuntu_gtk_widget_set_has_grab so we can grab sliders and 
    things in menus, needed by ido
* debian/patches/043_menu_proxy.patch
  - Add GtkMenuProxy support for remoting menus.
* debian/patches/062_dnd_menubar.patch:
  - Allow click on menubars for dnd
* debian/patches/063_treeview_almost_fixed.patch:
  - Add an ubuntu-almost-fixed-height-mode property, (required for
    software-center)
* debian/patches/071_no_offscreen_widgets_grabbing.patch:
  - Don't let offscreen widgets do grabbing
* debian/patches/072_indicator_menu_update.patch:
  - change by Cody Russell to send an update event on menu changes,
    should make the bluetooth indicator refresh correctly
* debian/patches/090_logging_file_saves.patch:
  - improve the logging of saved files
* debian/patches/092_default_to_xdg_document_dir.patch:
  - Use $XDG_DOCUMENTS_DIR as default directory rather than the home
    directory for the 'Print to File' function.
* debian/patches/093_gtk3_gtkimage_fallbacks_use.patch:
  - Backported gtk3 patch to add a "use-fallback" property to GtkImage, using 
    it "icon-name and GIcon type of GtkImages can use automatic fallback 
    names.", it will be useful for the indicator stack
* debian/patches/095_git_menus_scrolling.patch:
  - backported gtk3 commit to fix menu scrolling issues
* debian/patches/096_git_gtkprintsettings.patch:
  - upstream git commit backported from the gtk3 serie, don't ignore the 
    gtkprintsettings resolution settings 
* debian/patches/097_statusicon_image_fallback.patch: Make GtkStatusIcon
  images use fallbacks by default if the property is available.
* debian/patches/098_multiarch_module_path.patch:
  - Fallback to the pre-multiarch directory for compatibility
* debian/patches/099_printer_filename_fix.patch
  - Fix to the print dialog for print to file, make sure a non-hidden filename 
    is the default (LP: #488857)
* debian/patches/100_overlay_scrollbar_loading.patch
  - support for dynamically loading overlay scrollbars
* debian/patches/print-dialog-show-options-of-remote-dnssd-printers.patch:
  Make printing on remote DNS-SD/Bonjour-shared printers work
* Dropped changes:
  - Extra breaks/replaces not needed after Precise

[ Rico Tzschichholz ]
* 043_ubuntu_menu_proxy.patch: Refreshed

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/html/GtkFileChooser.html
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>GtkFileChooser</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.78.0">
7
7
<link rel="home" href="index.html" title="GTK+ 2 Reference Manual">
8
8
<link rel="up" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
9
9
<link rel="prev" href="GtkHSV.html" title="GtkHSV">
59
59
                                                         <em class="parameter"><code><a class="link" href="GtkFileChooser.html#GtkFileChooserAction" title="enum GtkFileChooserAction"><span class="type">GtkFileChooserAction</span></a> action</code></em>);
60
60
<a class="link" href="GtkFileChooser.html#GtkFileChooserAction" title="enum GtkFileChooserAction"><span class="returnvalue">GtkFileChooserAction</span></a> <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-action" title="gtk_file_chooser_get_action ()">gtk_file_chooser_get_action</a>        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
61
61
<span class="returnvalue">void</span>                <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-local-only" title="gtk_file_chooser_set_local_only ()">gtk_file_chooser_set_local_only</a>     (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
62
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> local_only</code></em>);
63
 
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-local-only" title="gtk_file_chooser_get_local_only ()">gtk_file_chooser_get_local_only</a>     (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
 
62
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> local_only</code></em>);
 
63
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-local-only" title="gtk_file_chooser_get_local_only ()">gtk_file_chooser_get_local_only</a>     (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
64
64
<span class="returnvalue">void</span>                <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-select-multiple" title="gtk_file_chooser_set_select_multiple ()">gtk_file_chooser_set_select_multiple</a>
65
65
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
66
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> select_multiple</code></em>);
67
 
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-select-multiple" title="gtk_file_chooser_get_select_multiple ()">gtk_file_chooser_get_select_multiple</a>
 
66
                                                         <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>);
 
67
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-select-multiple" title="gtk_file_chooser_get_select_multiple ()">gtk_file_chooser_get_select_multiple</a>
68
68
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
69
69
<span class="returnvalue">void</span>                <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-show-hidden" title="gtk_file_chooser_set_show_hidden ()">gtk_file_chooser_set_show_hidden</a>    (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
70
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> show_hidden</code></em>);
71
 
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-show-hidden" title="gtk_file_chooser_get_show_hidden ()">gtk_file_chooser_get_show_hidden</a>    (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
 
70
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_hidden</code></em>);
 
71
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-show-hidden" title="gtk_file_chooser_get_show_hidden ()">gtk_file_chooser_get_show_hidden</a>    (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
72
72
<span class="returnvalue">void</span>                <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-do-overwrite-confirmation" title="gtk_file_chooser_set_do_overwrite_confirmation ()">gtk_file_chooser_set_do_overwrite_confirmation</a>
73
73
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
74
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> do_overwrite_confirmation</code></em>);
75
 
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-do-overwrite-confirmation" title="gtk_file_chooser_get_do_overwrite_confirmation ()">gtk_file_chooser_get_do_overwrite_confirmation</a>
 
74
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> do_overwrite_confirmation</code></em>);
 
75
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-do-overwrite-confirmation" title="gtk_file_chooser_get_do_overwrite_confirmation ()">gtk_file_chooser_get_do_overwrite_confirmation</a>
76
76
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
77
77
<span class="returnvalue">void</span>                <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-create-folders" title="gtk_file_chooser_set_create_folders ()">gtk_file_chooser_set_create_folders</a> (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
78
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> create_folders</code></em>);
79
 
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-create-folders" title="gtk_file_chooser_get_create_folders ()">gtk_file_chooser_get_create_folders</a> (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
 
78
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> create_folders</code></em>);
 
79
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-create-folders" title="gtk_file_chooser_get_create_folders ()">gtk_file_chooser_get_create_folders</a> (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
80
80
<span class="returnvalue">void</span>                <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-name" title="gtk_file_chooser_set_current_name ()">gtk_file_chooser_set_current_name</a>   (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
81
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);
 
81
                                                         <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> *name</code></em>);
82
82
#define             <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filename" title="gtk_file_chooser_get_filename">gtk_file_chooser_get_filename</a>
83
83
#define             <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-filename" title="gtk_file_chooser_set_filename">gtk_file_chooser_set_filename</a>
84
84
#define             <a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-filename" title="gtk_file_chooser_select_filename">gtk_file_chooser_select_filename</a>
88
88
#define             <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filenames" title="gtk_file_chooser_get_filenames">gtk_file_chooser_get_filenames</a>
89
89
#define             <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder" title="gtk_file_chooser_set_current_folder">gtk_file_chooser_set_current_folder</a>
90
90
#define             <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-current-folder" title="gtk_file_chooser_get_current_folder">gtk_file_chooser_get_current_folder</a>
91
 
<span class="returnvalue">gchar</span> *             <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uri" title="gtk_file_chooser_get_uri ()">gtk_file_chooser_get_uri</a>            (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
92
 
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-uri" title="gtk_file_chooser_set_uri ()">gtk_file_chooser_set_uri</a>            (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
 
91
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uri" title="gtk_file_chooser_get_uri ()">gtk_file_chooser_get_uri</a>            (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
 
92
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-uri" title="gtk_file_chooser_set_uri ()">gtk_file_chooser_set_uri</a>            (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
93
93
                                                         <em class="parameter"><code>const <span class="type">char</span> *uri</code></em>);
94
 
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-uri" title="gtk_file_chooser_select_uri ()">gtk_file_chooser_select_uri</a>         (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
 
94
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-uri" title="gtk_file_chooser_select_uri ()">gtk_file_chooser_select_uri</a>         (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
95
95
                                                         <em class="parameter"><code>const <span class="type">char</span> *uri</code></em>);
96
96
<span class="returnvalue">void</span>                <a class="link" href="GtkFileChooser.html#gtk-file-chooser-unselect-uri" title="gtk_file_chooser_unselect_uri ()">gtk_file_chooser_unselect_uri</a>       (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
97
97
                                                         <em class="parameter"><code>const <span class="type">char</span> *uri</code></em>);
98
 
<span class="returnvalue">GSList</span> *            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uris" title="gtk_file_chooser_get_uris ()">gtk_file_chooser_get_uris</a>           (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
99
 
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder-uri" title="gtk_file_chooser_set_current_folder_uri ()">gtk_file_chooser_set_current_folder_uri</a>
 
98
<a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uris" title="gtk_file_chooser_get_uris ()">gtk_file_chooser_get_uris</a>           (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
 
99
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder-uri" title="gtk_file_chooser_set_current_folder_uri ()">gtk_file_chooser_set_current_folder_uri</a>
100
100
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
101
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *uri</code></em>);
102
 
<span class="returnvalue">gchar</span> *             <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-current-folder-uri" title="gtk_file_chooser_get_current_folder_uri ()">gtk_file_chooser_get_current_folder_uri</a>
 
101
                                                         <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> *uri</code></em>);
 
102
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-current-folder-uri" title="gtk_file_chooser_get_current_folder_uri ()">gtk_file_chooser_get_current_folder_uri</a>
103
103
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
104
104
<span class="returnvalue">void</span>                <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget" title="gtk_file_chooser_set_preview_widget ()">gtk_file_chooser_set_preview_widget</a> (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
105
105
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *preview_widget</code></em>);
106
106
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-widget" title="gtk_file_chooser_get_preview_widget ()">gtk_file_chooser_get_preview_widget</a> (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
107
107
<span class="returnvalue">void</span>                <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget-active" title="gtk_file_chooser_set_preview_widget_active ()">gtk_file_chooser_set_preview_widget_active</a>
108
108
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
109
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> active</code></em>);
110
 
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-widget-active" title="gtk_file_chooser_get_preview_widget_active ()">gtk_file_chooser_get_preview_widget_active</a>
 
109
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> active</code></em>);
 
110
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-widget-active" title="gtk_file_chooser_get_preview_widget_active ()">gtk_file_chooser_get_preview_widget_active</a>
111
111
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
112
112
<span class="returnvalue">void</span>                <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-use-preview-label" title="gtk_file_chooser_set_use_preview_label ()">gtk_file_chooser_set_use_preview_label</a>
113
113
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
114
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> use_label</code></em>);
115
 
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-use-preview-label" title="gtk_file_chooser_get_use_preview_label ()">gtk_file_chooser_get_use_preview_label</a>
 
114
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_label</code></em>);
 
115
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-use-preview-label" title="gtk_file_chooser_get_use_preview_label ()">gtk_file_chooser_get_use_preview_label</a>
116
116
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
117
117
#define             <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-filename" title="gtk_file_chooser_get_preview_filename">gtk_file_chooser_get_preview_filename</a>
118
118
<span class="returnvalue">char</span> *              <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-uri" title="gtk_file_chooser_get_preview_uri ()">gtk_file_chooser_get_preview_uri</a>    (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
123
123
                                                         <em class="parameter"><code><a class="link" href="gtk2-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a> *filter</code></em>);
124
124
<span class="returnvalue">void</span>                <a class="link" href="GtkFileChooser.html#gtk-file-chooser-remove-filter" title="gtk_file_chooser_remove_filter ()">gtk_file_chooser_remove_filter</a>      (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
125
125
                                                         <em class="parameter"><code><a class="link" href="gtk2-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a> *filter</code></em>);
126
 
<span class="returnvalue">GSList</span> *            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-list-filters" title="gtk_file_chooser_list_filters ()">gtk_file_chooser_list_filters</a>       (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
 
126
<a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-list-filters" title="gtk_file_chooser_list_filters ()">gtk_file_chooser_list_filters</a>       (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
127
127
<span class="returnvalue">void</span>                <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-filter" title="gtk_file_chooser_set_filter ()">gtk_file_chooser_set_filter</a>         (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
128
128
                                                         <em class="parameter"><code><a class="link" href="gtk2-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a> *filter</code></em>);
129
129
<a class="link" href="gtk2-gtkfilefilter.html#GtkFileFilter"><span class="returnvalue">GtkFileFilter</span></a> *     <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-filter" title="gtk_file_chooser_get_filter ()">gtk_file_chooser_get_filter</a>         (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
130
130
#define             <a class="link" href="GtkFileChooser.html#gtk-file-chooser-add-shortcut-folder" title="gtk_file_chooser_add_shortcut_folder">gtk_file_chooser_add_shortcut_folder</a>
131
131
#define             <a class="link" href="GtkFileChooser.html#gtk-file-chooser-remove-shortcut-folder" title="gtk_file_chooser_remove_shortcut_folder">gtk_file_chooser_remove_shortcut_folder</a>
132
132
#define             <a class="link" href="GtkFileChooser.html#gtk-file-chooser-list-shortcut-folders" title="gtk_file_chooser_list_shortcut_folders">gtk_file_chooser_list_shortcut_folders</a>
133
 
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-add-shortcut-folder-uri" title="gtk_file_chooser_add_shortcut_folder_uri ()">gtk_file_chooser_add_shortcut_folder_uri</a>
134
 
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
135
 
                                                         <em class="parameter"><code>const <span class="type">char</span> *uri</code></em>,
136
 
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
137
 
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-remove-shortcut-folder-uri" title="gtk_file_chooser_remove_shortcut_folder_uri ()">gtk_file_chooser_remove_shortcut_folder_uri</a>
138
 
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
139
 
                                                         <em class="parameter"><code>const <span class="type">char</span> *uri</code></em>,
140
 
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
141
 
<span class="returnvalue">GSList</span> *            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-list-shortcut-folder-uris" title="gtk_file_chooser_list_shortcut_folder_uris ()">gtk_file_chooser_list_shortcut_folder_uris</a>
142
 
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
143
 
<span class="returnvalue">GFile</span> *             <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-current-folder-file" title="gtk_file_chooser_get_current_folder_file ()">gtk_file_chooser_get_current_folder_file</a>
144
 
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
145
 
<span class="returnvalue">GFile</span> *             <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-file" title="gtk_file_chooser_get_file ()">gtk_file_chooser_get_file</a>           (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
146
 
<span class="returnvalue">GSList</span> *            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-files" title="gtk_file_chooser_get_files ()">gtk_file_chooser_get_files</a>          (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
147
 
<span class="returnvalue">GFile</span> *             <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-file" title="gtk_file_chooser_get_preview_file ()">gtk_file_chooser_get_preview_file</a>   (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
148
 
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-file" title="gtk_file_chooser_select_file ()">gtk_file_chooser_select_file</a>        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
149
 
                                                         <em class="parameter"><code><span class="type">GFile</span> *file</code></em>,
150
 
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
151
 
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder-file" title="gtk_file_chooser_set_current_folder_file ()">gtk_file_chooser_set_current_folder_file</a>
152
 
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
153
 
                                                         <em class="parameter"><code><span class="type">GFile</span> *file</code></em>,
154
 
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
155
 
<span class="returnvalue">gboolean</span>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-file" title="gtk_file_chooser_set_file ()">gtk_file_chooser_set_file</a>           (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
156
 
                                                         <em class="parameter"><code><span class="type">GFile</span> *file</code></em>,
157
 
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
 
133
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-add-shortcut-folder-uri" title="gtk_file_chooser_add_shortcut_folder_uri ()">gtk_file_chooser_add_shortcut_folder_uri</a>
 
134
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
 
135
                                                         <em class="parameter"><code>const <span class="type">char</span> *uri</code></em>,
 
136
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
 
137
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-remove-shortcut-folder-uri" title="gtk_file_chooser_remove_shortcut_folder_uri ()">gtk_file_chooser_remove_shortcut_folder_uri</a>
 
138
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
 
139
                                                         <em class="parameter"><code>const <span class="type">char</span> *uri</code></em>,
 
140
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
 
141
<a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-list-shortcut-folder-uris" title="gtk_file_chooser_list_shortcut_folder_uris ()">gtk_file_chooser_list_shortcut_folder_uris</a>
 
142
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
 
143
<a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="returnvalue">GFile</span></a> *             <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-current-folder-file" title="gtk_file_chooser_get_current_folder_file ()">gtk_file_chooser_get_current_folder_file</a>
 
144
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
 
145
<a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="returnvalue">GFile</span></a> *             <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-file" title="gtk_file_chooser_get_file ()">gtk_file_chooser_get_file</a>           (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
 
146
<a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-files" title="gtk_file_chooser_get_files ()">gtk_file_chooser_get_files</a>          (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
 
147
<a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="returnvalue">GFile</span></a> *             <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-file" title="gtk_file_chooser_get_preview_file ()">gtk_file_chooser_get_preview_file</a>   (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);
 
148
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-file" title="gtk_file_chooser_select_file ()">gtk_file_chooser_select_file</a>        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
 
149
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> *file</code></em>,
 
150
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
 
151
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder-file" title="gtk_file_chooser_set_current_folder_file ()">gtk_file_chooser_set_current_folder_file</a>
 
152
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
 
153
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> *file</code></em>,
 
154
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
 
155
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-file" title="gtk_file_chooser_set_file ()">gtk_file_chooser_set_file</a>           (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
 
156
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> *file</code></em>,
 
157
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
158
158
<span class="returnvalue">void</span>                <a class="link" href="GtkFileChooser.html#gtk-file-chooser-unselect-file" title="gtk_file_chooser_unselect_file ()">gtk_file_chooser_unselect_file</a>      (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
159
 
                                                         <em class="parameter"><code><span class="type">GFile</span> *file</code></em>);
 
159
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> *file</code></em>);
160
160
</pre>
161
161
</div>
162
162
<div class="refsect1">
182
182
<a name="GtkFileChooser.properties"></a><h2>Properties</h2>
183
183
<pre class="synopsis">
184
184
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser--action" title='The "action" property'>action</a>"                   <a class="link" href="GtkFileChooser.html#GtkFileChooserAction" title="enum GtkFileChooserAction"><span class="type">GtkFileChooserAction</span></a>  : Read / Write
185
 
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser--create-folders" title='The "create-folders" property'>create-folders</a>"           <span class="type">gboolean</span>              : Read / Write
186
 
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser--do-overwrite-confirmation" title='The "do-overwrite-confirmation" property'>do-overwrite-confirmation</a>" <span class="type">gboolean</span>              : Read / Write
 
185
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser--create-folders" title='The "create-folders" property'>create-folders</a>"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
186
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser--do-overwrite-confirmation" title='The "do-overwrite-confirmation" property'>do-overwrite-confirmation</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
187
187
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser--extra-widget" title='The "extra-widget" property'>extra-widget</a>"             <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>*            : Read / Write
188
 
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser--file-system-backend" title='The "file-system-backend" property'>file-system-backend</a>"      <span class="type">gchar</span>*                : Write / Construct Only
 
188
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser--file-system-backend" title='The "file-system-backend" property'>file-system-backend</a>"      <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Write / Construct Only
189
189
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser--filter" title='The "filter" property'>filter</a>"                   <a class="link" href="gtk2-gtkfilefilter.html#GtkFileFilter"><span class="type">GtkFileFilter</span></a>*        : Read / Write
190
 
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser--local-only" title='The "local-only" property'>local-only</a>"               <span class="type">gboolean</span>              : Read / Write
 
190
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser--local-only" title='The "local-only" property'>local-only</a>"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
191
191
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser--preview-widget" title='The "preview-widget" property'>preview-widget</a>"           <a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a>*            : Read / Write
192
 
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser--preview-widget-active" title='The "preview-widget-active" property'>preview-widget-active</a>"    <span class="type">gboolean</span>              : Read / Write
193
 
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser--select-multiple" title='The "select-multiple" property'>select-multiple</a>"          <span class="type">gboolean</span>              : Read / Write
194
 
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser--show-hidden" title='The "show-hidden" property'>show-hidden</a>"              <span class="type">gboolean</span>              : Read / Write
195
 
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser--use-preview-label" title='The "use-preview-label" property'>use-preview-label</a>"        <span class="type">gboolean</span>              : Read / Write
 
192
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser--preview-widget-active" title='The "preview-widget-active" property'>preview-widget-active</a>"    <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
193
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser--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
 
194
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser--show-hidden" title='The "show-hidden" property'>show-hidden</a>"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
 
195
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser--use-preview-label" title='The "use-preview-label" property'>use-preview-label</a>"        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
196
196
</pre>
197
197
</div>
198
198
<div class="refsect1">
199
199
<a name="GtkFileChooser.signals"></a><h2>Signals</h2>
200
200
<pre class="synopsis">
201
 
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser-confirm-overwrite" title='The "confirm-overwrite" signal'>confirm-overwrite</a>"                              : <code class="literal">Run Last</code>
202
 
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser-current-folder-changed" title='The "current-folder-changed" signal'>current-folder-changed</a>"                         : <code class="literal">Run Last</code>
203
 
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser-file-activated" title='The "file-activated" signal'>file-activated</a>"                                 : <code class="literal">Run Last</code>
204
 
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser-selection-changed" title='The "selection-changed" signal'>selection-changed</a>"                              : <code class="literal">Run Last</code>
205
 
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser-update-preview" title='The "update-preview" signal'>update-preview</a>"                                 : <code class="literal">Run Last</code>
 
201
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser-confirm-overwrite" title='The "confirm-overwrite" signal'>confirm-overwrite</a>"                              : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
 
202
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser-current-folder-changed" title='The "current-folder-changed" signal'>current-folder-changed</a>"                         : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
 
203
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser-file-activated" title='The "file-activated" signal'>file-activated</a>"                                 : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
 
204
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser-selection-changed" title='The "selection-changed" signal'>selection-changed</a>"                              : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
 
205
  "<a class="link" href="GtkFileChooser.html#GtkFileChooser-update-preview" title='The "update-preview" signal'>update-preview</a>"                                 : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
206
206
</pre>
207
207
</div>
208
208
<div class="refsect1">
277
277
   <code class="function">fopen(3)</code>, you may not be able to
278
278
   directly set it as the text of a <a class="link" href="GtkLabel.html" title="GtkLabel"><span class="type">GtkLabel</span></a> widget unless you
279
279
   convert it first to UTF-8, which all GTK+ widgets expect.
280
 
   You should use <code class="function">g_filename_to_utf8()</code> to convert filenames
 
280
   You should use <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> to convert filenames
281
281
   into strings that can be passed to GTK+ widgets.
282
282
</div>
283
283
</div>
350
350
<span class="normal">  preview </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkImage.html#gtk-image-new">gtk_image_new</a></span><span class="normal"> </span><span class="symbol">();</span>
351
351
 
352
352
<span class="normal">  </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget">gtk_file_chooser_set_preview_widget</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">my_file_chooser</span><span class="symbol">,</span><span class="normal"> preview</span><span class="symbol">);</span>
353
 
<span class="normal">  </span><span class="function">g_signal_connect</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">my_file_chooser</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"update-preview"</span><span class="symbol">,</span>
354
 
<span class="normal">            </span><span class="function">G_CALLBACK</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">update_preview_cb</span><span class="symbol">),</span><span class="normal"> preview</span><span class="symbol">);</span>
 
353
<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="normal">my_file_chooser</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"update-preview"</span><span class="symbol">,</span>
 
354
<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">update_preview_cb</span><span class="symbol">),</span><span class="normal"> preview</span><span class="symbol">);</span>
355
355
<span class="cbracket">}</span>
356
356
 
357
357
<span class="keyword">static</span><span class="normal"> </span><span class="type">void</span>
365
365
<span class="normal">  preview </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">data</span><span class="symbol">);</span>
366
366
<span class="normal">  filename </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-get-preview-filename">gtk_file_chooser_get_preview_filename</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">file_chooser</span><span class="symbol">);</span>
367
367
 
368
 
<span class="normal">  pixbuf </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file-at-size">gdk_pixbuf_new_from_file_at_size</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">filename</span><span class="symbol">,</span><span class="normal"> </span><span class="number">128</span><span class="symbol">,</span><span class="normal"> </span><span class="number">128</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>
369
 
<span class="normal">  have_preview </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">pixbuf </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>
370
 
<span class="normal">  </span><span class="function">g_free</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">filename</span><span class="symbol">);</span>
 
368
<span class="normal">  pixbuf </span><span class="symbol">=</span><span class="normal"> </span><span class="function">gdk_pixbuf_new_from_file_at_size</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">filename</span><span class="symbol">,</span><span class="normal"> </span><span class="number">128</span><span class="symbol">,</span><span class="normal"> </span><span class="number">128</span><span class="symbol">,</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
 
369
<span class="normal">  have_preview </span><span class="symbol">=</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">pixbuf </span><span class="symbol">!=</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
 
370
<span class="normal">  </span><span class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">filename</span><span class="symbol">);</span>
371
371
 
372
372
<span class="normal">  </span><span class="function"><a href="GtkImage.html#gtk-image-set-from-pixbuf">gtk_image_set_from_pixbuf</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_IMAGE</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">preview</span><span class="symbol">),</span><span class="normal"> pixbuf</span><span class="symbol">);</span>
373
373
<span class="normal">  </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">pixbuf</span><span class="symbol">)</span>
374
 
<span class="normal">    </span><span class="function">g_object_unref</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">pixbuf</span><span class="symbol">);</span>
 
374
<span class="normal">    </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">pixbuf</span><span class="symbol">);</span>
375
375
 
376
376
<span class="normal">  </span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget-active">gtk_file_chooser_set_preview_widget_active</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">file_chooser</span><span class="symbol">,</span><span class="normal"> have_preview</span><span class="symbol">);</span>
377
377
<span class="cbracket">}</span></pre></td>
468
468
<td>
469
469
                  <span class="keycap"><strong>Control</strong></span>+<span class="keycap"><strong>L</strong></span> (empty path);
470
470
                  <span class="keycap"><strong>/</strong></span> (path of "/")
471
 
               <a href="#ftn.idp82827008" class="footnote"><sup class="footnote"><a name="idp82827008"></a>[a]</sup></a>;
 
471
               <a href="#ftn.idm266999157024" class="footnote" name="idm266999157024"><sup class="footnote">[a]</sup></a>;
472
472
                  <span class="keycap"><strong>~</strong></span> (path of "~")
473
473
                </td>
474
474
</tr>
477
477
<td>
478
478
                  <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>Up</strong></span>;
479
479
               <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>Shift</strong></span>+<span class="keycap"><strong>Up</strong></span>
480
 
               <a href="#ftn.idp82834944" class="footnote"><sup class="footnote"><a name="idp82834944"></a>[b]</sup></a>;
 
480
               <a href="#ftn.idm266999149088" class="footnote" name="idm266999149088"><sup class="footnote">[b]</sup></a>;
481
481
                  <span class="keycap"><strong>Backspace</strong></span>
482
482
                </td>
483
483
</tr>
486
486
<td>
487
487
               <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>Down</strong></span>;
488
488
               <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>Shift</strong></span>+<span class="keycap"><strong>Down</strong></span>
489
 
               <a href="#ftn.idp82842096" class="footnote"><sup class="footnote"><a name="idp82842096"></a>[c]</sup></a>
 
489
               <a href="#ftn.idm266999141936" class="footnote" name="idm266999141936"><sup class="footnote">[c]</sup></a>
490
490
             </td>
491
491
</tr>
492
492
<tr>
509
509
</tr>
510
510
</tbody>
511
511
<tbody class="footnotes"><tr><td colspan="2">
512
 
<div id="ftn.idp82827008" class="footnote"><span class="keycap"><strong><a href="#idp82827008" class="keycap"><sup>[a] </sup></a>/</strong></span></div>
513
 
<div id="ftn.idp82834944" class="footnote"></div>
514
 
<div id="ftn.idp82842096" class="footnote"></div>
 
512
<div id="ftn.idm266999157024" class="footnote"><span class="keycap"><strong><a href="#idm266999157024" class="keycap"><sup>[a] </sup></a>/</strong></span></div>
 
513
<div id="ftn.idm266999149088" class="footnote"></div>
 
514
<div id="ftn.idm266999141936" class="footnote"></div>
515
515
</td></tr></tbody>
516
516
</table></div>
517
517
<p>
542
542
<pre class="programlisting">
543
543
   void user_function (GtkFileChooserDefault *chooser,
544
544
                       const char            *path,
545
 
gpointer      user_data);
 
545
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a>      user_data);
546
546
</pre>
547
547
<p>
548
548
This is used to make the file chooser show a "Location"
610
610
<a name="GtkFileChooserDefault-up-folder"></a><h4>The "GtkFileChooserDefault::up-folder" signal</h4>
611
611
<pre class="programlisting">
612
612
          void user_function (GtkFileChooserDefault *chooser,
613
 
                              gpointer user_data);
 
613
                              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data);
614
614
</pre>
615
615
<p>
616
616
This is used to make the file chooser go to the parent of
644
644
<a name="GtkFileChooserDefault-down-folder"></a><h4>The "GtkFileChooserDefault::down-folder" signal</h4>
645
645
<pre class="programlisting">
646
646
          void user_function (GtkFileChooserDefault *chooser,
647
 
                              gpointer user_data);
 
647
                              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data);
648
648
</pre>
649
649
<p>
650
650
This is used to make the file chooser go to a child of the
682
682
<a name="GtkFileChooserDefault-home-folder"></a><h4>The "GtkFileChooserDefault::home-folder" signal</h4>
683
683
<pre class="programlisting">
684
684
          void user_function (GtkFileChooserDefault *chooser,
685
 
                              gpointer user_data);
 
685
                              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data);
686
686
</pre>
687
687
<p>
688
688
This is used to make the file chooser show the user's home
715
715
<a name="GtkFileChooserDefault-desktop-folder"></a><h4>The "GtkFileChooserDefault::desktop-folder" signal</h4>
716
716
<pre class="programlisting">
717
717
          void user_function (GtkFileChooserDefault *chooser,
718
 
                              gpointer user_data);
 
718
                              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data);
719
719
</pre>
720
720
<p>
721
721
This is used to make the file chooser show the user's Desktop
748
748
<pre class="programlisting">
749
749
          void user_function (GtkFileChooserDefault *chooser,
750
750
                              gint bookmark_index,
751
 
                              gpointer user_data);
 
751
                              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data);
752
752
</pre>
753
753
<p>
754
754
This is used to make the file chooser switch to the bookmark
905
905
<pre class="programlisting">#define GTK_FILE_CHOOSER_ERROR (gtk_file_chooser_error_quark ())
906
906
</pre>
907
907
<p>
908
 
Used to get the <span class="type">GError</span> quark for <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> errors.
 
908
Used to get the <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> quark for <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> errors.
909
909
</p>
910
910
</div>
911
911
<hr>
1014
1014
<div class="refsect2">
1015
1015
<a name="gtk-file-chooser-set-local-only"></a><h3>gtk_file_chooser_set_local_only ()</h3>
1016
1016
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_file_chooser_set_local_only     (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
1017
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> local_only</code></em>);</pre>
 
1017
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> local_only</code></em>);</pre>
1018
1018
<p>
1019
1019
Sets whether only local files can be selected in the
1020
 
file selector. If <em class="parameter"><code>local_only</code></em> is <code class="literal">TRUE</code> (the default),
 
1020
file selector. If <em class="parameter"><code>local_only</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> (the default),
1021
1021
then the selected file are files are guaranteed to be
1022
1022
accessible through the operating systems native file
1023
1023
file system and therefore the application only
1040
1040
<tr>
1041
1041
<td><p><span class="term"><em class="parameter"><code>local_only</code></em> :</span></p></td>
1042
1042
<td>
1043
 
<code class="literal">TRUE</code> if only local files can be selected</td>
 
1043
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if only local files can be selected</td>
1044
1044
</tr>
1045
1045
</tbody>
1046
1046
</table></div>
1049
1049
<hr>
1050
1050
<div class="refsect2">
1051
1051
<a name="gtk-file-chooser-get-local-only"></a><h3>gtk_file_chooser_get_local_only ()</h3>
1052
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_file_chooser_get_local_only     (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
 
1052
<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_chooser_get_local_only     (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
1053
1053
<p>
1054
1054
Gets whether only local files can be selected in the
1055
1055
file selector. See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-local-only" title="gtk_file_chooser_set_local_only ()"><code class="function">gtk_file_chooser_set_local_only()</code></a>
1068
1068
<tr>
1069
1069
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1070
1070
<td>
1071
 
<code class="literal">TRUE</code> if only local files can be selected.</td>
 
1071
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if only local files can be selected.</td>
1072
1072
</tr>
1073
1073
</tbody>
1074
1074
</table></div>
1079
1079
<a name="gtk-file-chooser-set-select-multiple"></a><h3>gtk_file_chooser_set_select_multiple ()</h3>
1080
1080
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_file_chooser_set_select_multiple
1081
1081
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
1082
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> select_multiple</code></em>);</pre>
 
1082
                                                         <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>
1083
1083
<p>
1084
1084
Sets whether multiple files can be selected in the file selector.  This is
1085
1085
only relevant if the action is set to be <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-OPEN:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_OPEN</code></a> or
1099
1099
<tr>
1100
1100
<td><p><span class="term"><em class="parameter"><code>select_multiple</code></em> :</span></p></td>
1101
1101
<td>
1102
 
<code class="literal">TRUE</code> if multiple files can be selected.</td>
 
1102
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if multiple files can be selected.</td>
1103
1103
</tr>
1104
1104
</tbody>
1105
1105
</table></div>
1108
1108
<hr>
1109
1109
<div class="refsect2">
1110
1110
<a name="gtk-file-chooser-get-select-multiple"></a><h3>gtk_file_chooser_get_select_multiple ()</h3>
1111
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_file_chooser_get_select_multiple
 
1111
<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_chooser_get_select_multiple
1112
1112
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
1113
1113
<p>
1114
1114
Gets whether multiple files can be selected in the file
1128
1128
<tr>
1129
1129
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1130
1130
<td>
1131
 
<code class="literal">TRUE</code> if multiple files can be selected.</td>
 
1131
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if multiple files can be selected.</td>
1132
1132
</tr>
1133
1133
</tbody>
1134
1134
</table></div>
1138
1138
<div class="refsect2">
1139
1139
<a name="gtk-file-chooser-set-show-hidden"></a><h3>gtk_file_chooser_set_show_hidden ()</h3>
1140
1140
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_file_chooser_set_show_hidden    (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
1141
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> show_hidden</code></em>);</pre>
 
1141
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> show_hidden</code></em>);</pre>
1142
1142
<p>
1143
1143
Sets whether hidden files and folders are displayed in the file selector.
1144
1144
</p>
1156
1156
<tr>
1157
1157
<td><p><span class="term"><em class="parameter"><code>show_hidden</code></em> :</span></p></td>
1158
1158
<td>
1159
 
<code class="literal">TRUE</code> if hidden files and folders should be displayed.</td>
 
1159
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if hidden files and folders should be displayed.</td>
1160
1160
</tr>
1161
1161
</tbody>
1162
1162
</table></div>
1165
1165
<hr>
1166
1166
<div class="refsect2">
1167
1167
<a name="gtk-file-chooser-get-show-hidden"></a><h3>gtk_file_chooser_get_show_hidden ()</h3>
1168
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_file_chooser_get_show_hidden    (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
 
1168
<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_chooser_get_show_hidden    (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
1169
1169
<p>
1170
1170
Gets whether hidden files and folders are displayed in the file selector.   
1171
1171
See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-show-hidden" title="gtk_file_chooser_set_show_hidden ()"><code class="function">gtk_file_chooser_set_show_hidden()</code></a>.
1184
1184
<tr>
1185
1185
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1186
1186
<td>
1187
 
<code class="literal">TRUE</code> if hidden files and folders are displayed.</td>
 
1187
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if hidden files and folders are displayed.</td>
1188
1188
</tr>
1189
1189
</tbody>
1190
1190
</table></div>
1195
1195
<a name="gtk-file-chooser-set-do-overwrite-confirmation"></a><h3>gtk_file_chooser_set_do_overwrite_confirmation ()</h3>
1196
1196
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_file_chooser_set_do_overwrite_confirmation
1197
1197
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
1198
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> do_overwrite_confirmation</code></em>);</pre>
 
1198
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> do_overwrite_confirmation</code></em>);</pre>
1199
1199
<p>
1200
1200
Sets whether a file chooser in <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> mode will present
1201
1201
a confirmation dialog if the user types a file name that already exists.  This
1202
 
is <code class="literal">FALSE</code> by default.
 
1202
is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> by default.
1203
1203
</p>
1204
1204
<p>
1205
1205
Regardless of this setting, the <em class="parameter"><code>chooser</code></em> will emit the
1206
1206
<a class="link" href="GtkFileChooser.html#GtkFileChooser-confirm-overwrite" title='The "confirm-overwrite" signal'><span class="type">"confirm-overwrite"</span></a> signal when appropriate.
1207
1207
</p>
1208
1208
<p>
1209
 
If all you need is the stock confirmation dialog, set this property to <code class="literal">TRUE</code>.
 
1209
If all you need is the stock confirmation dialog, set this property to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.
1210
1210
You can override the way confirmation is done by actually handling the
1211
1211
<a class="link" href="GtkFileChooser.html#GtkFileChooser-confirm-overwrite" title='The "confirm-overwrite" signal'><span class="type">"confirm-overwrite"</span></a> signal; please refer to its documentation
1212
1212
for the details.
1233
1233
<hr>
1234
1234
<div class="refsect2">
1235
1235
<a name="gtk-file-chooser-get-do-overwrite-confirmation"></a><h3>gtk_file_chooser_get_do_overwrite_confirmation ()</h3>
1236
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_file_chooser_get_do_overwrite_confirmation
 
1236
<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_chooser_get_do_overwrite_confirmation
1237
1237
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
1238
1238
<p>
1239
1239
Queries whether a file chooser is set to confirm for overwriting when the user
1253
1253
<tr>
1254
1254
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1255
1255
<td>
1256
 
<code class="literal">TRUE</code> if the file chooser will present a confirmation dialog;
1257
 
<code class="literal">FALSE</code> otherwise.</td>
 
1256
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the file chooser will present a confirmation dialog;
 
1257
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
1258
1258
</tr>
1259
1259
</tbody>
1260
1260
</table></div>
1264
1264
<div class="refsect2">
1265
1265
<a name="gtk-file-chooser-set-create-folders"></a><h3>gtk_file_chooser_set_create_folders ()</h3>
1266
1266
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_file_chooser_set_create_folders (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
1267
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> create_folders</code></em>);</pre>
 
1267
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> create_folders</code></em>);</pre>
1268
1268
<p>
1269
1269
Sets whether file choser will offer to create new folders.
1270
1270
This is only relevant if the action is not set to be 
1284
1284
<tr>
1285
1285
<td><p><span class="term"><em class="parameter"><code>create_folders</code></em> :</span></p></td>
1286
1286
<td>
1287
 
<code class="literal">TRUE</code> if the New Folder button should be displayed</td>
 
1287
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the New Folder button should be displayed</td>
1288
1288
</tr>
1289
1289
</tbody>
1290
1290
</table></div>
1293
1293
<hr>
1294
1294
<div class="refsect2">
1295
1295
<a name="gtk-file-chooser-get-create-folders"></a><h3>gtk_file_chooser_get_create_folders ()</h3>
1296
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_file_chooser_get_create_folders (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
 
1296
<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_chooser_get_create_folders (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
1297
1297
<p>
1298
1298
Gets whether file choser will offer to create new folders.
1299
1299
See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-create-folders" title="gtk_file_chooser_set_create_folders ()"><code class="function">gtk_file_chooser_set_create_folders()</code></a>.
1312
1312
<tr>
1313
1313
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1314
1314
<td>
1315
 
<code class="literal">TRUE</code> if the New Folder button should be displayed.</td>
 
1315
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the New Folder button should be displayed.</td>
1316
1316
</tr>
1317
1317
</tbody>
1318
1318
</table></div>
1322
1322
<div class="refsect2">
1323
1323
<a name="gtk-file-chooser-set-current-name"></a><h3>gtk_file_chooser_set_current_name ()</h3>
1324
1324
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_file_chooser_set_current_name   (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
1325
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
 
1325
                                                         <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> *name</code></em>);</pre>
1326
1326
<p>
1327
1327
Sets the current name in the file selector, as if entered
1328
1328
by the user. Note that the name passed in here is a UTF-8
1382
1382
</tr>
1383
1383
<tr>
1384
1384
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1385
 
<td>The currently selected filename, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
1385
<td>The currently selected filename, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1386
1386
if no file is selected, or the selected file can't
1387
 
be represented with a local filename. Free with <code class="function">g_free()</code>. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename]</span>
 
1387
be represented with a local filename. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename]</span>
1388
1388
</td>
1389
1389
</tr>
1390
1390
</tbody>
1473
1473
<tr>
1474
1474
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1475
1475
<td>
1476
 
<code class="literal">TRUE</code> if both the folder could be changed and the file was
1477
 
selected successfully, <code class="literal">FALSE</code> otherwise.</td>
 
1476
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the file was
 
1477
selected successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
1478
1478
</tr>
1479
1479
</tbody>
1480
1480
</table></div>
1509
1509
<tr>
1510
1510
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1511
1511
<td>
1512
 
<code class="literal">TRUE</code> if both the folder could be changed and the file was
1513
 
selected successfully, <code class="literal">FALSE</code> otherwise.</td>
 
1512
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the file was
 
1513
selected successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
1514
1514
</tr>
1515
1515
</tbody>
1516
1516
</table></div>
1610
1610
</tr>
1611
1611
<tr>
1612
1612
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1613
 
<td>a <span class="type">GSList</span>
 
1613
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>
1614
1614
containing the filenames of all selected files and subfolders in
1615
 
the current folder. Free the returned list with <code class="function">g_slist_free()</code>,
1616
 
and the filenames with <code class="function">g_free()</code>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> filename][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 
1615
the current folder. Free the returned list with <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>,
 
1616
and the filenames with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> filename][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1617
1617
</td>
1618
1618
</tr>
1619
1619
</tbody>
1649
1649
<tr>
1650
1650
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1651
1651
<td>
1652
 
<code class="literal">TRUE</code> if the folder could be changed successfully, <code class="literal">FALSE</code>
 
1652
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be changed successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
1653
1653
otherwise.</td>
1654
1654
</tr>
1655
1655
</tbody>
1688
1688
<tr>
1689
1689
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1690
1690
<td>the full path of the current folder,
1691
 
or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if the current path cannot be represented as a local
1692
 
filename.  Free with <code class="function">g_free()</code>.  This function will also return
1693
 
<a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if the file chooser was unable to load the last folder that
 
1691
or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the current path cannot be represented as a local
 
1692
filename.  Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.  This function will also return
 
1693
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the file chooser was unable to load the last folder that
1694
1694
was requested from it; for example, as would be for calling
1695
1695
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder" title="gtk_file_chooser_set_current_folder"><code class="function">gtk_file_chooser_set_current_folder()</code></a> on a nonexistent folder. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename]</span>
1696
1696
</td>
1702
1702
<hr>
1703
1703
<div class="refsect2">
1704
1704
<a name="gtk-file-chooser-get-uri"></a><h3>gtk_file_chooser_get_uri ()</h3>
1705
 
<pre class="programlisting"><span class="returnvalue">gchar</span> *             gtk_file_chooser_get_uri            (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
 
1705
<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_chooser_get_uri            (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
1706
1706
<p>
1707
1707
Gets the URI for the currently selected file in
1708
1708
the file selector. If multiple files are selected,
1725
1725
</tr>
1726
1726
<tr>
1727
1727
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1728
 
<td>The currently selected URI, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>
1729
 
if no file is selected. Free with <code class="function">g_free()</code>
 
1728
<td>The currently selected URI, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
1729
if no file is selected. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>
1730
1730
</td>
1731
1731
</tr>
1732
1732
</tbody>
1736
1736
<hr>
1737
1737
<div class="refsect2">
1738
1738
<a name="gtk-file-chooser-set-uri"></a><h3>gtk_file_chooser_set_uri ()</h3>
1739
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_file_chooser_set_uri            (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
 
1739
<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_chooser_set_uri            (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
1740
1740
                                                         <em class="parameter"><code>const <span class="type">char</span> *uri</code></em>);</pre>
1741
1741
<p>
1742
1742
Sets the file referred to by <em class="parameter"><code>uri</code></em> as the current file for the file chooser,
1812
1812
<tr>
1813
1813
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1814
1814
<td>
1815
 
<code class="literal">TRUE</code> if both the folder could be changed and the URI was
1816
 
selected successfully, <code class="literal">FALSE</code> otherwise.</td>
 
1815
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the URI was
 
1816
selected successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
1817
1817
</tr>
1818
1818
</tbody>
1819
1819
</table></div>
1822
1822
<hr>
1823
1823
<div class="refsect2">
1824
1824
<a name="gtk-file-chooser-select-uri"></a><h3>gtk_file_chooser_select_uri ()</h3>
1825
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_file_chooser_select_uri         (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
 
1825
<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_chooser_select_uri         (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
1826
1826
                                                         <em class="parameter"><code>const <span class="type">char</span> *uri</code></em>);</pre>
1827
1827
<p>
1828
1828
Selects the file to by <em class="parameter"><code>uri</code></em>. If the URI doesn't refer to a
1847
1847
<tr>
1848
1848
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1849
1849
<td>
1850
 
<code class="literal">TRUE</code> if both the folder could be changed and the URI was
1851
 
selected successfully, <code class="literal">FALSE</code> otherwise.</td>
 
1850
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the URI was
 
1851
selected successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
1852
1852
</tr>
1853
1853
</tbody>
1854
1854
</table></div>
1886
1886
<hr>
1887
1887
<div class="refsect2">
1888
1888
<a name="gtk-file-chooser-get-uris"></a><h3>gtk_file_chooser_get_uris ()</h3>
1889
 
<pre class="programlisting"><span class="returnvalue">GSList</span> *            gtk_file_chooser_get_uris           (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
 
1889
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *            gtk_file_chooser_get_uris           (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
1890
1890
<p>
1891
1891
Lists all the selected files and subfolders in the current folder of
1892
1892
<em class="parameter"><code>chooser</code></em>. The returned names are full absolute URIs.
1904
1904
</tr>
1905
1905
<tr>
1906
1906
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1907
 
<td>a <span class="type">GSList</span> containing the URIs of all selected
 
1907
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> containing the URIs of all selected
1908
1908
files and subfolders in the current folder. Free the returned list
1909
 
with <code class="function">g_slist_free()</code>, and the filenames with <code class="function">g_free()</code>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 
1909
with <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>, and the filenames with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1910
1910
</td>
1911
1911
</tr>
1912
1912
</tbody>
1916
1916
<hr>
1917
1917
<div class="refsect2">
1918
1918
<a name="gtk-file-chooser-set-current-folder-uri"></a><h3>gtk_file_chooser_set_current_folder_uri ()</h3>
1919
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_file_chooser_set_current_folder_uri
 
1919
<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_chooser_set_current_folder_uri
1920
1920
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
1921
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *uri</code></em>);</pre>
 
1921
                                                         <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> *uri</code></em>);</pre>
1922
1922
<p>
1923
1923
Sets the current folder for <em class="parameter"><code>chooser</code></em> from an URI.
1924
1924
The user will be shown the full contents of the current folder,
1942
1942
<tr>
1943
1943
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1944
1944
<td>
1945
 
<code class="literal">TRUE</code> if the folder could be changed successfully, <code class="literal">FALSE</code>
 
1945
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be changed successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
1946
1946
otherwise.</td>
1947
1947
</tr>
1948
1948
</tbody>
1952
1952
<hr>
1953
1953
<div class="refsect2">
1954
1954
<a name="gtk-file-chooser-get-current-folder-uri"></a><h3>gtk_file_chooser_get_current_folder_uri ()</h3>
1955
 
<pre class="programlisting"><span class="returnvalue">gchar</span> *             gtk_file_chooser_get_current_folder_uri
 
1955
<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_chooser_get_current_folder_uri
1956
1956
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
1957
1957
<p>
1958
1958
Gets the current folder of <em class="parameter"><code>chooser</code></em> as an URI.
1980
1980
</tr>
1981
1981
<tr>
1982
1982
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1983
 
<td>the URI for the current folder.  Free with <code class="function">g_free()</code>.  This
1984
 
function will also return <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if the file chooser was unable to load the
 
1983
<td>the URI for the current folder.  Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.  This
 
1984
function will also return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the file chooser was unable to load the
1985
1985
last folder that was requested from it; for example, as would be for calling
1986
1986
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder-uri" title="gtk_file_chooser_set_current_folder_uri ()"><code class="function">gtk_file_chooser_set_current_folder_uri()</code></a> on a nonexistent folder.</td>
1987
1987
</tr>
2050
2050
</tr>
2051
2051
<tr>
2052
2052
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2053
 
<td>the current preview widget, 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="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
2053
<td>the current preview widget, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2054
2054
</td>
2055
2055
</tr>
2056
2056
</tbody>
2062
2062
<a name="gtk-file-chooser-set-preview-widget-active"></a><h3>gtk_file_chooser_set_preview_widget_active ()</h3>
2063
2063
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_file_chooser_set_preview_widget_active
2064
2064
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
2065
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> active</code></em>);</pre>
 
2065
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> active</code></em>);</pre>
2066
2066
<p>
2067
2067
Sets whether the preview widget set by
2068
2068
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget" title="gtk_file_chooser_set_preview_widget ()"><code class="function">gtk_file_chooser_set_preview_widget()</code></a> should be shown for the
2093
2093
<hr>
2094
2094
<div class="refsect2">
2095
2095
<a name="gtk-file-chooser-get-preview-widget-active"></a><h3>gtk_file_chooser_get_preview_widget_active ()</h3>
2096
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_file_chooser_get_preview_widget_active
 
2096
<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_chooser_get_preview_widget_active
2097
2097
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
2098
2098
<p>
2099
2099
Gets whether the preview widget set by <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-preview-widget" title="gtk_file_chooser_set_preview_widget ()"><code class="function">gtk_file_chooser_set_preview_widget()</code></a>
2114
2114
<tr>
2115
2115
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2116
2116
<td>
2117
 
<code class="literal">TRUE</code> if the preview widget is active for the current filename.</td>
 
2117
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the preview widget is active for the current filename.</td>
2118
2118
</tr>
2119
2119
</tbody>
2120
2120
</table></div>
2125
2125
<a name="gtk-file-chooser-set-use-preview-label"></a><h3>gtk_file_chooser_set_use_preview_label ()</h3>
2126
2126
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_file_chooser_set_use_preview_label
2127
2127
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
2128
 
                                                         <em class="parameter"><code><span class="type">gboolean</span> use_label</code></em>);</pre>
 
2128
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_label</code></em>);</pre>
2129
2129
<p>
2130
2130
Sets whether the file chooser should display a stock label with the name of
2131
 
the file that is being previewed; the default is <code class="literal">TRUE</code>.  Applications that
2132
 
want to draw the whole preview area themselves should set this to <code class="literal">FALSE</code> and
 
2131
the file that is being previewed; the default is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.  Applications that
 
2132
want to draw the whole preview area themselves should set this to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> and
2133
2133
display the name themselves in their preview widget.
2134
2134
</p>
2135
2135
<p>
2157
2157
<hr>
2158
2158
<div class="refsect2">
2159
2159
<a name="gtk-file-chooser-get-use-preview-label"></a><h3>gtk_file_chooser_get_use_preview_label ()</h3>
2160
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_file_chooser_get_use_preview_label
 
2160
<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_chooser_get_use_preview_label
2161
2161
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
2162
2162
<p>
2163
2163
Gets whether a stock label should be drawn with the name of the previewed
2177
2177
<tr>
2178
2178
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2179
2179
<td>
2180
 
<code class="literal">TRUE</code> if the file chooser is set to display a label with the
2181
 
name of the previewed file, <code class="literal">FALSE</code> otherwise.</td>
 
2180
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the file chooser is set to display a label with the
 
2181
name of the previewed file, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
2182
2182
</tr>
2183
2183
</tbody>
2184
2184
</table></div>
2205
2205
</tr>
2206
2206
<tr>
2207
2207
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2208
 
<td>the filename to preview, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if
 
2208
<td>the filename to preview, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
2209
2209
no file is selected, or if the selected file cannot be represented
2210
 
as a local filename. Free with <code class="function">g_free()</code>. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename]</span>
 
2210
as a local filename. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. <span class="annotation">[<acronym title="Override the parsed C type with given type"><span class="acronym">type</span></acronym> filename]</span>
2211
2211
</td>
2212
2212
</tr>
2213
2213
</tbody>
2235
2235
</tr>
2236
2236
<tr>
2237
2237
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2238
 
<td>the URI for the file to preview, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if no file is
2239
 
selected. Free with <code class="function">g_free()</code>.</td>
 
2238
<td>the URI for the file to preview, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no file is
 
2239
selected. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</td>
2240
2240
</tr>
2241
2241
</tbody>
2242
2242
</table></div>
2290
2290
</tr>
2291
2291
<tr>
2292
2292
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2293
 
<td>the current extra widget, 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="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
2293
<td>the current extra widget, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2294
2294
</td>
2295
2295
</tr>
2296
2296
</tbody>
2362
2362
<hr>
2363
2363
<div class="refsect2">
2364
2364
<a name="gtk-file-chooser-list-filters"></a><h3>gtk_file_chooser_list_filters ()</h3>
2365
 
<pre class="programlisting"><span class="returnvalue">GSList</span> *            gtk_file_chooser_list_filters       (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
 
2365
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *            gtk_file_chooser_list_filters       (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
2366
2366
<p>
2367
2367
Lists the current set of user-selectable filters; see
2368
2368
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-add-filter" title="gtk_file_chooser_add_filter ()"><code class="function">gtk_file_chooser_add_filter()</code></a>, <a class="link" href="GtkFileChooser.html#gtk-file-chooser-remove-filter" title="gtk_file_chooser_remove_filter ()"><code class="function">gtk_file_chooser_remove_filter()</code></a>.
2381
2381
<tr>
2382
2382
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2383
2383
<td>a
2384
 
<span class="type">GSList</span> containing the current set of user selectable filters. The
 
2384
<a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> containing the current set of user selectable filters. The
2385
2385
contents of the list are owned by GTK+, but you must free the list
2386
 
itself with <code class="function">g_slist_free()</code> when you are done with it. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkFileFilter][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span>
 
2386
itself with <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a> when you are done with it. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkFileFilter][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span>
2387
2387
</td>
2388
2388
</tr>
2389
2389
</tbody>
2443
2443
</tr>
2444
2444
<tr>
2445
2445
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2446
 
<td>the current filter, 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="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
2446
<td>the current filter, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
2447
2447
</td>
2448
2448
</tr>
2449
2449
</tbody>
2479
2479
</tr>
2480
2480
<tr>
2481
2481
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2482
 
<td>location to store error, 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>
 
2482
<td>location to store error, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.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>
2483
2483
</td>
2484
2484
</tr>
2485
2485
<tr>
2486
2486
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2487
2487
<td>
2488
 
<code class="literal">TRUE</code> if the folder could be added successfully, <code class="literal">FALSE</code>
 
2488
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be added successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
2489
2489
otherwise.  In the latter case, the <em class="parameter"><code>error</code></em> will be set as appropriate.</td>
2490
2490
</tr>
2491
2491
</tbody>
2518
2518
</tr>
2519
2519
<tr>
2520
2520
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2521
 
<td>location to store error, 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>
 
2521
<td>location to store error, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.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>
2522
2522
</td>
2523
2523
</tr>
2524
2524
<tr>
2525
2525
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2526
2526
<td>
2527
 
<code class="literal">TRUE</code> if the operation succeeds, <code class="literal">FALSE</code> otherwise.
 
2527
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeds, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
2528
2528
In the latter case, the <em class="parameter"><code>error</code></em> will be set as appropriate.
2529
2529
See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-add-shortcut-folder" title="gtk_file_chooser_add_shortcut_folder"><code class="function">gtk_file_chooser_add_shortcut_folder()</code></a>
2530
2530
</td>
2556
2556
<tr>
2557
2557
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2558
2558
<td>A list of
2559
 
folder filenames, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if there are no shortcut folders.  Free
2560
 
the returned list with <code class="function">g_slist_free()</code>, and the filenames with
2561
 
<code class="function">g_free()</code>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> filename][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 
2559
folder filenames, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there are no shortcut folders.  Free
 
2560
the returned list with <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>, and the filenames with
 
2561
<a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> filename][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2562
2562
</td>
2563
2563
</tr>
2564
2564
</tbody>
2568
2568
<hr>
2569
2569
<div class="refsect2">
2570
2570
<a name="gtk-file-chooser-add-shortcut-folder-uri"></a><h3>gtk_file_chooser_add_shortcut_folder_uri ()</h3>
2571
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_file_chooser_add_shortcut_folder_uri
 
2571
<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_chooser_add_shortcut_folder_uri
2572
2572
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
2573
2573
                                                         <em class="parameter"><code>const <span class="type">char</span> *uri</code></em>,
2574
 
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
 
2574
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2575
2575
<p>
2576
2576
Adds a folder URI to be displayed with the shortcut folders in a file
2577
2577
chooser.  Note that shortcut folders do not get saved, as they are provided
2595
2595
</tr>
2596
2596
<tr>
2597
2597
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2598
 
<td>location to store error, 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>
 
2598
<td>location to store error, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.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>
2599
2599
</td>
2600
2600
</tr>
2601
2601
<tr>
2602
2602
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2603
2603
<td>
2604
 
<code class="literal">TRUE</code> if the folder could be added successfully, <code class="literal">FALSE</code>
 
2604
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be added successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
2605
2605
otherwise.  In the latter case, the <em class="parameter"><code>error</code></em> will be set as appropriate.</td>
2606
2606
</tr>
2607
2607
</tbody>
2611
2611
<hr>
2612
2612
<div class="refsect2">
2613
2613
<a name="gtk-file-chooser-remove-shortcut-folder-uri"></a><h3>gtk_file_chooser_remove_shortcut_folder_uri ()</h3>
2614
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_file_chooser_remove_shortcut_folder_uri
 
2614
<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_chooser_remove_shortcut_folder_uri
2615
2615
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
2616
2616
                                                         <em class="parameter"><code>const <span class="type">char</span> *uri</code></em>,
2617
 
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
 
2617
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2618
2618
<p>
2619
2619
Removes a folder URI from a file chooser's list of shortcut folders.
2620
2620
</p>
2635
2635
</tr>
2636
2636
<tr>
2637
2637
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2638
 
<td>location to store error, 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>
 
2638
<td>location to store error, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.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>
2639
2639
</td>
2640
2640
</tr>
2641
2641
<tr>
2642
2642
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2643
2643
<td>
2644
 
<code class="literal">TRUE</code> if the operation succeeds, <code class="literal">FALSE</code> otherwise.
 
2644
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the operation succeeds, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
2645
2645
In the latter case, the <em class="parameter"><code>error</code></em> will be set as appropriate.
2646
2646
See also: <a class="link" href="GtkFileChooser.html#gtk-file-chooser-add-shortcut-folder-uri" title="gtk_file_chooser_add_shortcut_folder_uri ()"><code class="function">gtk_file_chooser_add_shortcut_folder_uri()</code></a>
2647
2647
</td>
2653
2653
<hr>
2654
2654
<div class="refsect2">
2655
2655
<a name="gtk-file-chooser-list-shortcut-folder-uris"></a><h3>gtk_file_chooser_list_shortcut_folder_uris ()</h3>
2656
 
<pre class="programlisting"><span class="returnvalue">GSList</span> *            gtk_file_chooser_list_shortcut_folder_uris
 
2656
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *            gtk_file_chooser_list_shortcut_folder_uris
2657
2657
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
2658
2658
<p>
2659
2659
Queries the list of shortcut folders in the file chooser, as set by
2673
2673
<tr>
2674
2674
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2675
2675
<td>A list of folder
2676
 
URIs, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if there are no shortcut folders.  Free the returned
2677
 
list with <code class="function">g_slist_free()</code>, and the URIs with <code class="function">g_free()</code>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 
2676
URIs, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there are no shortcut folders.  Free the returned
 
2677
list with <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>, and the URIs with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2678
2678
</td>
2679
2679
</tr>
2680
2680
</tbody>
2684
2684
<hr>
2685
2685
<div class="refsect2">
2686
2686
<a name="gtk-file-chooser-get-current-folder-file"></a><h3>gtk_file_chooser_get_current_folder_file ()</h3>
2687
 
<pre class="programlisting"><span class="returnvalue">GFile</span> *             gtk_file_chooser_get_current_folder_file
 
2687
<pre class="programlisting"><a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="returnvalue">GFile</span></a> *             gtk_file_chooser_get_current_folder_file
2688
2688
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
2689
2689
<p>
2690
 
Gets the current folder of <em class="parameter"><code>chooser</code></em> as <span class="type">GFile</span>.
 
2690
Gets the current folder of <em class="parameter"><code>chooser</code></em> as <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a>.
2691
2691
See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-current-folder-uri" title="gtk_file_chooser_get_current_folder_uri ()"><code class="function">gtk_file_chooser_get_current_folder_uri()</code></a>.
2692
2692
</p>
2693
2693
<div class="variablelist"><table border="0" class="variablelist">
2703
2703
</tr>
2704
2704
<tr>
2705
2705
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2706
 
<td>the <span class="type">GFile</span> for the current folder. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 
2706
<td>the <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> for the current folder. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2707
2707
</td>
2708
2708
</tr>
2709
2709
</tbody>
2713
2713
<hr>
2714
2714
<div class="refsect2">
2715
2715
<a name="gtk-file-chooser-get-file"></a><h3>gtk_file_chooser_get_file ()</h3>
2716
 
<pre class="programlisting"><span class="returnvalue">GFile</span> *             gtk_file_chooser_get_file           (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
 
2716
<pre class="programlisting"><a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="returnvalue">GFile</span></a> *             gtk_file_chooser_get_file           (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
2717
2717
<p>
2718
 
Gets the <span class="type">GFile</span> for the currently selected file in
 
2718
Gets the <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> for the currently selected file in
2719
2719
the file selector. If multiple files are selected,
2720
2720
one of the files will be returned at random.
2721
2721
</p>
2736
2736
</tr>
2737
2737
<tr>
2738
2738
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2739
 
<td>a selected <span class="type">GFile</span>. You own the returned file;
2740
 
use <code class="function">g_object_unref()</code> to release it. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 
2739
<td>a selected <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a>. You own the returned file;
 
2740
use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> to release it. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2741
2741
</td>
2742
2742
</tr>
2743
2743
</tbody>
2747
2747
<hr>
2748
2748
<div class="refsect2">
2749
2749
<a name="gtk-file-chooser-get-files"></a><h3>gtk_file_chooser_get_files ()</h3>
2750
 
<pre class="programlisting"><span class="returnvalue">GSList</span> *            gtk_file_chooser_get_files          (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
 
2750
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="returnvalue">GSList</span></a> *            gtk_file_chooser_get_files          (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
2751
2751
<p>
2752
2752
Lists all the selected files and subfolders in the current folder of <em class="parameter"><code>chooser</code></em>
2753
 
as <span class="type">GFile</span>. An internal function, see <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uris" title="gtk_file_chooser_get_uris ()"><code class="function">gtk_file_chooser_get_uris()</code></a>.
 
2753
as <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a>. An internal function, see <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uris" title="gtk_file_chooser_get_uris ()"><code class="function">gtk_file_chooser_get_uris()</code></a>.
2754
2754
</p>
2755
2755
<div class="variablelist"><table border="0" class="variablelist">
2756
2756
<colgroup>
2765
2765
</tr>
2766
2766
<tr>
2767
2767
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2768
 
<td>a <span class="type">GSList</span>
2769
 
containing a <span class="type">GFile</span> for each selected file and subfolder in the
2770
 
current folder.  Free the returned list with <code class="function">g_slist_free()</code>, and
2771
 
the files with <code class="function">g_object_unref()</code>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GFile][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 
2768
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>
 
2769
containing a <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> for each selected file and subfolder in the
 
2770
current folder.  Free the returned list with <a href="http://library.gnome.org/devel/glib/unstable/glib-Singly-Linked-Lists.html#g-slist-free"><code class="function">g_slist_free()</code></a>, and
 
2771
the files with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GFile][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2772
2772
</td>
2773
2773
</tr>
2774
2774
</tbody>
2778
2778
<hr>
2779
2779
<div class="refsect2">
2780
2780
<a name="gtk-file-chooser-get-preview-file"></a><h3>gtk_file_chooser_get_preview_file ()</h3>
2781
 
<pre class="programlisting"><span class="returnvalue">GFile</span> *             gtk_file_chooser_get_preview_file   (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
 
2781
<pre class="programlisting"><a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="returnvalue">GFile</span></a> *             gtk_file_chooser_get_preview_file   (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
2782
2782
<p>
2783
 
Gets the <span class="type">GFile</span> that should be previewed in a custom preview
 
2783
Gets the <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> that should be previewed in a custom preview
2784
2784
Internal function, see <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-preview-uri" title="gtk_file_chooser_get_preview_uri ()"><code class="function">gtk_file_chooser_get_preview_uri()</code></a>.
2785
2785
</p>
2786
2786
<div class="variablelist"><table border="0" class="variablelist">
2796
2796
</tr>
2797
2797
<tr>
2798
2798
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2799
 
<td>the <span class="type">GFile</span> for the file to preview,
2800
 
or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if no file is selected. Free with <code class="function">g_object_unref()</code>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
 
2799
<td>the <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> for the file to preview,
 
2800
or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no file is selected. Free with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
2801
2801
</td>
2802
2802
</tr>
2803
2803
</tbody>
2807
2807
<hr>
2808
2808
<div class="refsect2">
2809
2809
<a name="gtk-file-chooser-select-file"></a><h3>gtk_file_chooser_select_file ()</h3>
2810
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_file_chooser_select_file        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
2811
 
                                                         <em class="parameter"><code><span class="type">GFile</span> *file</code></em>,
2812
 
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
 
2810
<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_chooser_select_file        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
 
2811
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> *file</code></em>,
 
2812
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2813
2813
<p>
2814
2814
Selects the file referred to by <em class="parameter"><code>file</code></em>. An internal function. See
2815
2815
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-select-uri" title="gtk_file_chooser_select_uri ()"><code class="function">_gtk_file_chooser_select_uri()</code></a>.
2831
2831
</tr>
2832
2832
<tr>
2833
2833
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2834
 
<td>location to store error, 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>
 
2834
<td>location to store error, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.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>
2835
2835
</td>
2836
2836
</tr>
2837
2837
<tr>
2838
2838
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2839
2839
<td>
2840
 
<code class="literal">TRUE</code> if both the folder could be changed and the path was
2841
 
selected successfully, <code class="literal">FALSE</code> otherwise.</td>
 
2840
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the path was
 
2841
selected successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
2842
2842
</tr>
2843
2843
</tbody>
2844
2844
</table></div>
2847
2847
<hr>
2848
2848
<div class="refsect2">
2849
2849
<a name="gtk-file-chooser-set-current-folder-file"></a><h3>gtk_file_chooser_set_current_folder_file ()</h3>
2850
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_file_chooser_set_current_folder_file
 
2850
<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_chooser_set_current_folder_file
2851
2851
                                                        (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
2852
 
                                                         <em class="parameter"><code><span class="type">GFile</span> *file</code></em>,
2853
 
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
 
2852
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> *file</code></em>,
 
2853
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2854
2854
<p>
2855
 
Sets the current folder for <em class="parameter"><code>chooser</code></em> from a <span class="type">GFile</span>.
 
2855
Sets the current folder for <em class="parameter"><code>chooser</code></em> from a <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a>.
2856
2856
Internal function, see <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folder-uri" title="gtk_file_chooser_set_current_folder_uri ()"><code class="function">gtk_file_chooser_set_current_folder_uri()</code></a>.
2857
2857
</p>
2858
2858
<div class="variablelist"><table border="0" class="variablelist">
2868
2868
</tr>
2869
2869
<tr>
2870
2870
<td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2871
 
<td>the <span class="type">GFile</span> for the new folder</td>
 
2871
<td>the <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> for the new folder</td>
2872
2872
</tr>
2873
2873
<tr>
2874
2874
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2875
 
<td>location to store error, 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>
 
2875
<td>location to store error, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.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>
2876
2876
</td>
2877
2877
</tr>
2878
2878
<tr>
2879
2879
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2880
2880
<td>
2881
 
<code class="literal">TRUE</code> if the folder could be changed successfully, <code class="literal">FALSE</code>
 
2881
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the folder could be changed successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>
2882
2882
otherwise.</td>
2883
2883
</tr>
2884
2884
</tbody>
2888
2888
<hr>
2889
2889
<div class="refsect2">
2890
2890
<a name="gtk-file-chooser-set-file"></a><h3>gtk_file_chooser_set_file ()</h3>
2891
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_file_chooser_set_file           (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
2892
 
                                                         <em class="parameter"><code><span class="type">GFile</span> *file</code></em>,
2893
 
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
 
2891
<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_chooser_set_file           (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
 
2892
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> *file</code></em>,
 
2893
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
2894
2894
<p>
2895
2895
Sets <em class="parameter"><code>file</code></em> as the current filename for the file chooser, by changing
2896
2896
to the file's parent folder and actually selecting the file in list.  If
2962
2962
</tr>
2963
2963
<tr>
2964
2964
<td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
2965
 
<td>the <span class="type">GFile</span> to set as current</td>
 
2965
<td>the <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> to set as current</td>
2966
2966
</tr>
2967
2967
<tr>
2968
2968
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
2969
 
<td>location to store the error, or <a href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore errors. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
 
2969
<td>location to store the error, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore errors. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
2970
2970
</td>
2971
2971
</tr>
2972
2972
<tr>
2973
2973
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
2974
2974
<td>
2975
 
<code class="literal">TRUE</code> if both the folder could be changed and the file was
2976
 
selected successfully, <code class="literal">FALSE</code> otherwise.</td>
 
2975
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if both the folder could be changed and the file was
 
2976
selected successfully, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
2977
2977
</tr>
2978
2978
</tbody>
2979
2979
</table></div>
2983
2983
<div class="refsect2">
2984
2984
<a name="gtk-file-chooser-unselect-file"></a><h3>gtk_file_chooser_unselect_file ()</h3>
2985
2985
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_file_chooser_unselect_file      (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
2986
 
                                                         <em class="parameter"><code><span class="type">GFile</span> *file</code></em>);</pre>
 
2986
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a> *file</code></em>);</pre>
2987
2987
<p>
2988
2988
Unselects the file referred to by <em class="parameter"><code>file</code></em>. If the file is not in the current
2989
2989
directory, does not exist, or is otherwise not currently selected, does nothing.
3001
3001
</tr>
3002
3002
<tr>
3003
3003
<td><p><span class="term"><em class="parameter"><code>file</code></em> :</span></p></td>
3004
 
<td>a <span class="type">GFile</span>
 
3004
<td>a <a href="http://library.gnome.org/devel/gio/unstable/GFile.html"><span class="type">GFile</span></a>
3005
3005
</td>
3006
3006
</tr>
3007
3007
</tbody>
3020
3020
<hr>
3021
3021
<div class="refsect2">
3022
3022
<a name="GtkFileChooser--create-folders"></a><h3>The <code class="literal">"create-folders"</code> property</h3>
3023
 
<pre class="programlisting">  "create-folders"           <span class="type">gboolean</span>              : Read / Write</pre>
 
3023
<pre class="programlisting">  "create-folders"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
3024
3024
<p>
3025
3025
Whether a file chooser not in <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-OPEN:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_OPEN</code></a> mode
3026
3026
will offer the user to create new folders.
3031
3031
<hr>
3032
3032
<div class="refsect2">
3033
3033
<a name="GtkFileChooser--do-overwrite-confirmation"></a><h3>The <code class="literal">"do-overwrite-confirmation"</code> property</h3>
3034
 
<pre class="programlisting">  "do-overwrite-confirmation" <span class="type">gboolean</span>              : Read / Write</pre>
 
3034
<pre class="programlisting">  "do-overwrite-confirmation" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
3035
3035
<p>
3036
3036
Whether a file chooser in <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> mode
3037
3037
will present an overwrite confirmation dialog if the user
3049
3049
<hr>
3050
3050
<div class="refsect2">
3051
3051
<a name="GtkFileChooser--file-system-backend"></a><h3>The <code class="literal">"file-system-backend"</code> property</h3>
3052
 
<pre class="programlisting">  "file-system-backend"      <span class="type">gchar</span>*                : Write / Construct Only</pre>
 
3052
<pre class="programlisting">  "file-system-backend"      <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Write / Construct Only</pre>
3053
3053
<p>Name of file system backend to use.</p>
3054
3054
<p>Default value: NULL</p>
3055
3055
</div>
3062
3062
<hr>
3063
3063
<div class="refsect2">
3064
3064
<a name="GtkFileChooser--local-only"></a><h3>The <code class="literal">"local-only"</code> property</h3>
3065
 
<pre class="programlisting">  "local-only"               <span class="type">gboolean</span>              : Read / Write</pre>
 
3065
<pre class="programlisting">  "local-only"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
3066
3066
<p>Whether the selected file(s) should be limited to local file: URLs.</p>
3067
3067
<p>Default value: TRUE</p>
3068
3068
</div>
3075
3075
<hr>
3076
3076
<div class="refsect2">
3077
3077
<a name="GtkFileChooser--preview-widget-active"></a><h3>The <code class="literal">"preview-widget-active"</code> property</h3>
3078
 
<pre class="programlisting">  "preview-widget-active"    <span class="type">gboolean</span>              : Read / Write</pre>
 
3078
<pre class="programlisting">  "preview-widget-active"    <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
3079
3079
<p>Whether the application supplied widget for custom previews should be shown.</p>
3080
3080
<p>Default value: TRUE</p>
3081
3081
</div>
3082
3082
<hr>
3083
3083
<div class="refsect2">
3084
3084
<a name="GtkFileChooser--select-multiple"></a><h3>The <code class="literal">"select-multiple"</code> property</h3>
3085
 
<pre class="programlisting">  "select-multiple"          <span class="type">gboolean</span>              : Read / Write</pre>
 
3085
<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>
3086
3086
<p>Whether to allow multiple files to be selected.</p>
3087
3087
<p>Default value: FALSE</p>
3088
3088
</div>
3089
3089
<hr>
3090
3090
<div class="refsect2">
3091
3091
<a name="GtkFileChooser--show-hidden"></a><h3>The <code class="literal">"show-hidden"</code> property</h3>
3092
 
<pre class="programlisting">  "show-hidden"              <span class="type">gboolean</span>              : Read / Write</pre>
 
3092
<pre class="programlisting">  "show-hidden"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
3093
3093
<p>Whether the hidden files and folders should be displayed.</p>
3094
3094
<p>Default value: FALSE</p>
3095
3095
</div>
3096
3096
<hr>
3097
3097
<div class="refsect2">
3098
3098
<a name="GtkFileChooser--use-preview-label"></a><h3>The <code class="literal">"use-preview-label"</code> property</h3>
3099
 
<pre class="programlisting">  "use-preview-label"        <span class="type">gboolean</span>              : Read / Write</pre>
 
3099
<pre class="programlisting">  "use-preview-label"        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
3100
3100
<p>Whether to display a stock label with the name of the previewed file.</p>
3101
3101
<p>Default value: TRUE</p>
3102
3102
</div>
3106
3106
<div class="refsect2">
3107
3107
<a name="GtkFileChooser-confirm-overwrite"></a><h3>The <code class="literal">"confirm-overwrite"</code> signal</h3>
3108
3108
<pre class="programlisting"><a class="link" href="GtkFileChooser.html#GtkFileChooserConfirmation" title="enum GtkFileChooserConfirmation"><span class="returnvalue">GtkFileChooserConfirmation</span></a>user_function                      (<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser,
3109
 
                                                        <span class="type">gpointer</span>        user_data)      : <code class="literal">Run Last</code></pre>
 
3109
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>        user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
3110
3110
<p>
3111
3111
This signal gets emitted whenever it is appropriate to present a
3112
3112
confirmation dialog when the user has selected a file name that
3189
3189
 
3190
3190
<span class="normal">chooser </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkFileChooserDialog.html#gtk-file-chooser-dialog-new">gtk_file_chooser_dialog_new</a></span><span class="normal"> </span><span class="symbol">(...);</span>
3191
3191
 
3192
 
<span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-do-overwrite-confirmation">gtk_file_chooser_set_do_overwrite_confirmation</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_FILE_CHOOSER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">dialog</span><span class="symbol">),</span><span class="normal"> TRUE</span><span class="symbol">);</span>
3193
 
<span class="function">g_signal_connect</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"confirm-overwrite"</span><span class="symbol">,</span>
3194
 
<span class="normal">                  </span><span class="function">G_CALLBACK</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">confirm_overwrite_callback</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>
 
3192
<span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-set-do-overwrite-confirmation">gtk_file_chooser_set_do_overwrite_confirmation</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_FILE_CHOOSER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">dialog</span><span class="symbol">),</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">);</span>
 
3193
<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="normal">chooser</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"confirm-overwrite"</span><span class="symbol">,</span>
 
3194
<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">confirm_overwrite_callback</span><span class="symbol">),</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
3195
3195
 
3196
3196
<span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="GtkDialog.html#gtk-dialog-run">gtk_dialog_run</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">)</span><span class="normal"> </span><span class="symbol">==</span><span class="normal"> <a href="GtkDialog.html#GTK-RESPONSE-ACCEPT:CAPS">GTK_RESPONSE_ACCEPT</a></span><span class="symbol">)</span>
3197
3197
<span class="normal">        </span><span class="function">save_to_file</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="GtkFileChooser.html#gtk-file-chooser-get-filename">gtk_file_chooser_get_filename</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_FILE_CHOOSER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">chooser</span><span class="symbol">));</span>
3232
3232
<div class="refsect2">
3233
3233
<a name="GtkFileChooser-current-folder-changed"></a><h3>The <code class="literal">"current-folder-changed"</code> signal</h3>
3234
3234
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser,
3235
 
                                                        <span class="type">gpointer</span>        user_data)      : <code class="literal">Run Last</code></pre>
 
3235
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>        user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
3236
3236
<p>
3237
3237
This signal is emitted when the current folder in a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a>
3238
3238
changes.  This can happen due to the user performing some action that
3271
3271
<div class="refsect2">
3272
3272
<a name="GtkFileChooser-file-activated"></a><h3>The <code class="literal">"file-activated"</code> signal</h3>
3273
3273
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser,
3274
 
                                                        <span class="type">gpointer</span>        user_data)      : <code class="literal">Run Last</code></pre>
 
3274
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>        user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
3275
3275
<p>
3276
3276
This signal is emitted when the user "activates" a file in the file
3277
3277
chooser.  This can happen by double-clicking on a file in the file list, or
3308
3308
<div class="refsect2">
3309
3309
<a name="GtkFileChooser-selection-changed"></a><h3>The <code class="literal">"selection-changed"</code> signal</h3>
3310
3310
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser,
3311
 
                                                        <span class="type">gpointer</span>        user_data)      : <code class="literal">Run Last</code></pre>
 
3311
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>        user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
3312
3312
<p>
3313
3313
This signal is emitted when there is a change in the set of selected files
3314
3314
in a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a>.  This can happen when the user modifies the selection
3348
3348
<div class="refsect2">
3349
3349
<a name="GtkFileChooser-update-preview"></a><h3>The <code class="literal">"update-preview"</code> signal</h3>
3350
3350
<pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser,
3351
 
                                                        <span class="type">gpointer</span>        user_data)      : <code class="literal">Run Last</code></pre>
 
3351
                                                        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>        user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
3352
3352
<p>
3353
3353
This signal is emitted when the preview in a file chooser should be
3354
3354
regenerated.  For example, this can happen when the currently selected file