~bratsche/ubuntu/maverick/gtk+2.0/menu-activation-fix

« back to all changes in this revision

Viewing changes to docs/reference/gtk/xml/gtkfilechooser.xml

Import upstream version 2.17.11

Show diffs side-by-side

added added

removed removed

Lines of Context:
48
48
                                                         <link linkend="gboolean">gboolean</link> do_overwrite_confirmation);
49
49
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-file-chooser-get-do-overwrite-confirmation">gtk_file_chooser_get_do_overwrite_confirmation</link>
50
50
                                                        (<link linkend="GtkFileChooser">GtkFileChooser</link> *chooser);
 
51
<link linkend="void">void</link>                <link linkend="gtk-file-chooser-set-create-folders">gtk_file_chooser_set_create_folders</link> (<link linkend="GtkFileChooser">GtkFileChooser</link> *chooser,
 
52
                                                         <link linkend="gboolean">gboolean</link> create_folders);
 
53
<link linkend="gboolean">gboolean</link>            <link linkend="gtk-file-chooser-get-create-folders">gtk_file_chooser_get_create_folders</link> (<link linkend="GtkFileChooser">GtkFileChooser</link> *chooser);
51
54
<link linkend="void">void</link>                <link linkend="gtk-file-chooser-set-current-name">gtk_file_chooser_set_current_name</link>   (<link linkend="GtkFileChooser">GtkFileChooser</link> *chooser,
52
55
                                                         const <link linkend="gchar">gchar</link> *name);
53
56
<link linkend="gchar">gchar</link> *             <link linkend="gtk-file-chooser-get-filename">gtk_file_chooser_get_filename</link>       (<link linkend="GtkFileChooser">GtkFileChooser</link> *chooser);
171
174
<title role="properties.title">Properties</title>
172
175
<synopsis>
173
176
  &quot;<link linkend="GtkFileChooser--action">action</link>&quot;                   <link linkend="GtkFileChooserAction">GtkFileChooserAction</link>  : Read / Write
 
177
  &quot;<link linkend="GtkFileChooser--create-folders">create-folders</link>&quot;           <link linkend="gboolean">gboolean</link>              : Read / Write
174
178
  &quot;<link linkend="GtkFileChooser--do-overwrite-confirmation">do-overwrite-confirmation</link>&quot; <link linkend="gboolean">gboolean</link>              : Read / Write
175
179
  &quot;<link linkend="GtkFileChooser--extra-widget">extra-widget</link>&quot;             <link linkend="GtkWidget">GtkWidget</link>*            : Read / Write
176
180
  &quot;<link linkend="GtkFileChooser--file-system-backend">file-system-backend</link>&quot;      <link linkend="gchar">gchar</link>*                : Write / Construct Only
999
1003
 
1000
1004
</simpara></listitem></varlistentry>
1001
1005
</variablelist><para role="since">Since 2.8</para></refsect2>
 
1006
<refsect2 id="gtk-file-chooser-set-create-folders" role="function" condition="since:2.18">
 
1007
<title>gtk_file_chooser_set_create_folders ()</title>
 
1008
<indexterm zone="gtk-file-chooser-set-create-folders" role="2.18"><primary sortas="file_chooser_set_create_folders">gtk_file_chooser_set_create_folders</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_file_chooser_set_create_folders (<link linkend="GtkFileChooser">GtkFileChooser</link> *chooser,
 
1009
                                                         <link linkend="gboolean">gboolean</link> create_folders);</programlisting>
 
1010
<para>
 
1011
Sets whether file choser will offer to create new folders.
 
1012
This is only relevant if the action is not set to be 
 
1013
GTK_FILE_CHOOSER_ACTION_OPEN.</para>
 
1014
<para>
 
1015
</para><variablelist role="params">
 
1016
<varlistentry><term><parameter>chooser</parameter>&#160;:</term>
 
1017
<listitem><simpara> a <link linkend="GtkFileChooser"><type>GtkFileChooser</type></link>
 
1018
</simpara></listitem></varlistentry>
 
1019
<varlistentry><term><parameter>create_folders</parameter>&#160;:</term>
 
1020
<listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the New Folder button should be displayed
 
1021
</simpara></listitem></varlistentry>
 
1022
</variablelist><para role="since">Since 2.18</para></refsect2>
 
1023
<refsect2 id="gtk-file-chooser-get-create-folders" role="function" condition="since:2.18">
 
1024
<title>gtk_file_chooser_get_create_folders ()</title>
 
1025
<indexterm zone="gtk-file-chooser-get-create-folders" role="2.18"><primary sortas="file_chooser_get_create_folders">gtk_file_chooser_get_create_folders</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            gtk_file_chooser_get_create_folders (<link linkend="GtkFileChooser">GtkFileChooser</link> *chooser);</programlisting>
 
1026
<para>
 
1027
Gets whether file choser will offer to create new folders.
 
1028
See <link linkend="gtk-file-chooser-set-create-folders"><function>gtk_file_chooser_set_create_folders()</function></link>.</para>
 
1029
<para>
 
1030
</para><variablelist role="params">
 
1031
<varlistentry><term><parameter>chooser</parameter>&#160;:</term>
 
1032
<listitem><simpara> a <link linkend="GtkFileChooser"><type>GtkFileChooser</type></link>
 
1033
</simpara></listitem></varlistentry>
 
1034
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the New Folder button should be displayed.
 
1035
 
 
1036
</simpara></listitem></varlistentry>
 
1037
</variablelist><para role="since">Since 2.18</para></refsect2>
1002
1038
<refsect2 id="gtk-file-chooser-set-current-name" role="function" condition="since:2.4">
1003
1039
<title>gtk_file_chooser_set_current_name ()</title>
1004
1040
<indexterm zone="gtk-file-chooser-set-current-name" role="2.4"><primary sortas="file_chooser_set_current_name">gtk_file_chooser_set_current_name</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_file_chooser_set_current_name   (<link linkend="GtkFileChooser">GtkFileChooser</link> *chooser,
1850
1886
<varlistentry><term><parameter>chooser</parameter>&#160;:</term>
1851
1887
<listitem><simpara> a <link linkend="GtkFileChooser"><type>GtkFileChooser</type></link>
1852
1888
</simpara></listitem></varlistentry>
1853
 
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a selected <link linkend="GFile"><type>GFile</type></link>
 
1889
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a selected <link linkend="GFile"><type>GFile</type></link>. You own the returned file; use
 
1890
         <link linkend="g-object-unref"><function>g_object_unref()</function></link> to release it.
1854
1891
 
1855
1892
</simpara></listitem></varlistentry>
1856
1893
</variablelist><para role="since">Since 2.14</para></refsect2>
2018
2055
<indexterm zone="GtkFileChooser--action"><primary sortas="FileChooser:action">GtkFileChooser:action</primary></indexterm><programlisting>  &quot;action&quot;                   <link linkend="GtkFileChooserAction">GtkFileChooserAction</link>  : Read / Write</programlisting>
2019
2056
<para>The type of operation that the file selector is performing.</para><para>Default value: GTK_FILE_CHOOSER_ACTION_OPEN</para>
2020
2057
</refsect2>
 
2058
<refsect2 id="GtkFileChooser--create-folders" role="property"><title>The <literal>&quot;create-folders&quot;</literal> property</title>
 
2059
<indexterm zone="GtkFileChooser--create-folders" role="2.18"><primary sortas="FileChooser:create-folders">GtkFileChooser:create-folders</primary></indexterm><programlisting>  &quot;create-folders&quot;           <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
 
2060
<para>
 
2061
Whether a file chooser not in <link linkend="GTK-FILE-CHOOSER-ACTION-OPEN--CAPS"><literal>GTK_FILE_CHOOSER_ACTION_OPEN</literal></link> mode
 
2062
will offer the user to create new folders.</para>
 
2063
<para>
 
2064
</para><para>Default value: TRUE</para>
 
2065
<para>Since 2.18</para>
 
2066
</refsect2>
2021
2067
<refsect2 id="GtkFileChooser--do-overwrite-confirmation" role="property"><title>The <literal>&quot;do-overwrite-confirmation&quot;</literal> property</title>
2022
2068
<indexterm zone="GtkFileChooser--do-overwrite-confirmation" role="2.8"><primary sortas="FileChooser:do-overwrite-confirmation">GtkFileChooser:do-overwrite-confirmation</primary></indexterm><programlisting>  &quot;do-overwrite-confirmation&quot; <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
2023
2069
<para>