callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

New upstream version 3.24.18

Browse Source
This commit is contained in:
Simon McVittie
2020-04-10 15:23:16 +01:00
parent ecf5b7f34b f9decb0cd6
commit ea8a581be2
386 changed files with 78008 additions and 6390 deletions
Download Patch File Download Diff File Expand all files Collapse all files

222
docs/reference/gtk/html/GtkFileChooser.html
View File

@ -54,7 +54,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GtkFileChooserAction"><span class="returnvalue">GtkFileChooserAction</span></a>
<a class="link" href="GtkFileChooser.html#GtkFileChooserAction" title="enum GtkFileChooserAction"><span class="returnvalue">GtkFileChooserAction</span></a>
</td>
<td class="function_name">
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-action" title="gtk_file_chooser_get_action ()">gtk_file_chooser_get_action</a> <span class="c_punctuation">()</span>
@ -560,7 +560,7 @@
</colgroup>
<tbody>
<tr>
<td class="property_type"><a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GtkFileChooserAction"><span class="type">GtkFileChooserAction</span></a></td>
<td class="property_type"><a class="link" href="GtkFileChooser.html#GtkFileChooserAction" title="enum GtkFileChooserAction"><span class="type">GtkFileChooserAction</span></a></td>
<td class="property_name"><a class="link" href="GtkFileChooser.html#GtkFileChooser--action" title="The “action” property">action</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -630,7 +630,7 @@
</colgroup>
<tbody>
<tr>
<td class="signal_type"><a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GtkFileChooserConfirmation"><span class="returnvalue">GtkFileChooserConfirmation</span></a></td>
<td class="signal_type"><a class="link" href="GtkFileChooser.html#GtkFileChooserConfirmation" title="enum GtkFileChooserConfirmation"><span class="returnvalue">GtkFileChooserConfirmation</span></a></td>
<td class="signal_name"><a class="link" href="GtkFileChooser.html#GtkFileChooser-confirm-overwrite" title="The “confirm-overwrite” signal">confirm-overwrite</a></td>
<td class="signal_flags">Run Last</td>
</tr>
@ -667,23 +667,23 @@
<tbody>
<tr>
<td class="datatype_keyword"> </td>
<td class="function_name"><a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GtkFileChooser-struct">GtkFileChooser</a></td>
<td class="function_name"><a class="link" href="GtkFileChooser.html#GtkFileChooser-struct" title="GtkFileChooser">GtkFileChooser</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GtkFileChooserAction">GtkFileChooserAction</a></td>
<td class="function_name"><a class="link" href="GtkFileChooser.html#GtkFileChooserAction" title="enum GtkFileChooserAction">GtkFileChooserAction</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GtkFileChooserConfirmation">GtkFileChooserConfirmation</a></td>
<td class="function_name"><a class="link" href="GtkFileChooser.html#GtkFileChooserConfirmation" title="enum GtkFileChooserConfirmation">GtkFileChooserConfirmation</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GTK-FILE-CHOOSER-ERROR:CAPS">GTK_FILE_CHOOSER_ERROR</a></td>
<td class="function_name"><a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ERROR:CAPS" title="GTK_FILE_CHOOSER_ERROR">GTK_FILE_CHOOSER_ERROR</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GtkFileChooserError">GtkFileChooserError</a></td>
<td class="function_name"><a class="link" href="GtkFileChooser.html#GtkFileChooserError" title="enum GtkFileChooserError">GtkFileChooserError</a></td>
</tr>
</tbody>
</table></div>
@ -897,12 +897,12 @@ the whole extra widget.</p>
<a name="gtk-file-chooser-set-action"></a><h3>gtk_file_chooser_set_action ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_file_chooser_set_action (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GtkFileChooserAction"><span class="type">GtkFileChooserAction</span></a> action</code></em>);</pre>
<em class="parameter"><code><a class="link" href="GtkFileChooser.html#GtkFileChooserAction" title="enum GtkFileChooserAction"><span class="type">GtkFileChooserAction</span></a> action</code></em>);</pre>
<p>Sets the type of operation that the chooser is performing; the
user interface is adapted to suit the selected action. For example,
an option to create a new folder might be shown if the action is
<a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> but not if the action is
<a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-OPEN:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_OPEN</code></a>.</p>
<a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> but not if the action is
<a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-OPEN:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_OPEN</code></a>.</p>
<div class="refsect3">
<a name="gtk-file-chooser-set-action.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -930,7 +930,7 @@ an option to create a new folder might be shown if the action is
<hr>
<div class="refsect2">
<a name="gtk-file-chooser-get-action"></a><h3>gtk_file_chooser_get_action ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GtkFileChooserAction"><span class="returnvalue">GtkFileChooserAction</span></a>
<pre class="programlisting"><a class="link" href="GtkFileChooser.html#GtkFileChooserAction" title="enum GtkFileChooserAction"><span class="returnvalue">GtkFileChooserAction</span></a>
gtk_file_chooser_get_action (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>);</pre>
<p>Gets the type of operation that the file chooser is performing; see
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-action" title="gtk_file_chooser_set_action ()"><code class="function">gtk_file_chooser_set_action()</code></a>.</p>
@ -1033,8 +1033,8 @@ file selector. See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-se
gtk_file_chooser_set_select_multiple (<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> select_multiple</code></em>);</pre>
<p>Sets whether multiple files can be selected in the file selector. This is
only relevant if the action is set to be <a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-OPEN:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_OPEN</code></a> or
<a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SELECT-FOLDER:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER</code></a>.</p>
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
<a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SELECT-FOLDER:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER</code></a>.</p>
<div class="refsect3">
<a name="gtk-file-chooser-set-select-multiple.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -1153,7 +1153,7 @@ See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-show-hidden"
gtk_file_chooser_set_do_overwrite_confirmation
(<em class="parameter"><code><a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> *chooser</code></em>,
<em class="parameter"><code><span class="type">gboolean</span> do_overwrite_confirmation</code></em>);</pre>
<p>Sets whether a file chooser in <a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> mode will present
<p>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
a confirmation dialog if the user types a file name that already exists. This
is <code class="literal">FALSE</code> by default.</p>
<p>If set to <code class="literal">TRUE</code>, the <em class="parameter"><code>chooser</code></em>
@ -1225,7 +1225,7 @@ gtk_file_chooser_set_create_folders (<em class="parameter"><code><a class="link"
<em class="parameter"><code><span class="type">gboolean</span> create_folders</code></em>);</pre>
<p>Sets whether file choser will offer to create new folders.
This is only relevant if the action is not set to be
<a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-OPEN:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_OPEN</code></a>.</p>
<a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-OPEN:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_OPEN</code></a>.</p>
<div class="refsect3">
<a name="gtk-file-chooser-set-create-folders.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -1400,7 +1400,7 @@ gtk_file_chooser_set_filename (<em class="parameter"><code><a class="link" href=
the file’s parent folder and actually selecting the file in list; all other
files will be unselected. If the <em class="parameter"><code>chooser</code></em>
is in
<a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> mode, the file’s base name will also appear in
<a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> mode, the file’s base name will also appear in
the dialog’s file name entry.</p>
<p>Note that the file must exist, or nothing will be done except
for the directory change.</p>
@ -1679,7 +1679,7 @@ See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folde
<p>Note that this is the folder that the file chooser is currently displaying
(e.g. "/home/username/Documents"), which is not the same
as the currently-selected folder if the chooser is in
<a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SELECT-FOLDER:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER</code></a> mode
<a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SELECT-FOLDER:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER</code></a> mode
(e.g. "/home/username/Documents/selected-folder/". To get the
currently-selected folder in that mode, use <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uri" title="gtk_file_chooser_get_uri ()"><code class="function">gtk_file_chooser_get_uri()</code></a> as the
usual way to get the selection.</p>
@ -1755,7 +1755,7 @@ gtk_file_chooser_set_uri (<em class="parameter"><code><a class="link" href="GtkF
as the current file for the file chooser,
by changing to the URI’s parent folder and actually selecting the URI in the
list. If the <em class="parameter"><code>chooser</code></em>
is <a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> mode, the URI’s base
is <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> mode, the URI’s base
name will also appear in the dialog’s file name entry.</p>
<p>Note that the URI must exist, or nothing will be done except for the
directory change.</p>
@ -1989,7 +1989,7 @@ See <a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-current-folde
<p>Note that this is the folder that the file chooser is currently displaying
(e.g. "file:///home/username/Documents"), which is not the same
as the currently-selected folder if the chooser is in
<a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SELECT-FOLDER:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER</code></a> mode
<a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SELECT-FOLDER:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER</code></a> mode
(e.g. "file:///home/username/Documents/selected-folder/". To get the
currently-selected folder in that mode, use <a class="link" href="GtkFileChooser.html#gtk-file-chooser-get-uri" title="gtk_file_chooser_get_uri ()"><code class="function">gtk_file_chooser_get_uri()</code></a> as the
usual way to get the selection.</p>
@ -3142,7 +3142,7 @@ gtk_file_chooser_set_file (<em class="parameter"><code><a class="link" href="Gtk
as the current filename for the file chooser, by changing
to the file’s parent folder and actually selecting the file in list. If
the <em class="parameter"><code>chooser</code></em>
is in <a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> mode, the file’s base name
is in <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> mode, the file’s base name
will also appear in the dialog’s file name entry.</p>
<p>If the file name isn’t in the current folder of <em class="parameter"><code>chooser</code></em>
, then the current
@ -3260,10 +3260,170 @@ directory, does not exist, or is otherwise not currently selected, does nothing.
</div>
</div>
<div class="refsect1">
<a name="GtkFileChooser.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="GtkFileChooser-struct"></a><h3>GtkFileChooser</h3>
<pre class="programlisting">typedef struct _GtkFileChooser GtkFileChooser;</pre>
</div>
<hr>
<div class="refsect2">
<a name="GtkFileChooserAction"></a><h3>enum GtkFileChooserAction</h3>
<p>Describes whether a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> is being used to open existing files
or to save to a possibly new file.</p>
<div class="refsect3">
<a name="GtkFileChooserAction.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ACTION-OPEN:CAPS"></a>GTK_FILE_CHOOSER_ACTION_OPEN</p></td>
<td class="enum_member_description">
<p>Indicates open mode. The file chooser
will only let the user pick an existing file.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"></a>GTK_FILE_CHOOSER_ACTION_SAVE</p></td>
<td class="enum_member_description">
<p>Indicates save mode. The file chooser
will let the user pick an existing file, or type in a new
filename.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ACTION-SELECT-FOLDER:CAPS"></a>GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER</p></td>
<td class="enum_member_description">
<p>Indicates an Open mode for
selecting folders. The file chooser will let the user pick an
existing folder.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ACTION-CREATE-FOLDER:CAPS"></a>GTK_FILE_CHOOSER_ACTION_CREATE_FOLDER</p></td>
<td class="enum_member_description">
<p>Indicates a mode for creating a
new folder. The file chooser will let the user name an existing or
new folder.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="GtkFileChooserConfirmation"></a><h3>enum GtkFileChooserConfirmation</h3>
<p>Used as a return value of handlers for the
<a class="link" href="GtkFileChooser.html#GtkFileChooser-confirm-overwrite" title="The “confirm-overwrite” signal"><span class="type">“confirm-overwrite”</span></a> signal of a <a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a>. This
value determines whether the file chooser will present the stock
confirmation dialog, accept the user’s choice of a filename, or
let the user choose another filename.</p>
<div class="refsect3">
<a name="GtkFileChooserConfirmation.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-CONFIRMATION-CONFIRM:CAPS"></a>GTK_FILE_CHOOSER_CONFIRMATION_CONFIRM</p></td>
<td class="enum_member_description">
<p>The file chooser will present
its stock dialog to confirm about overwriting an existing file.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-CONFIRMATION-ACCEPT-FILENAME:CAPS"></a>GTK_FILE_CHOOSER_CONFIRMATION_ACCEPT_FILENAME</p></td>
<td class="enum_member_description">
<p>The file chooser will
terminate and accept the user’s choice of a file name.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-CONFIRMATION-SELECT-AGAIN:CAPS"></a>GTK_FILE_CHOOSER_CONFIRMATION_SELECT_AGAIN</p></td>
<td class="enum_member_description">
<p>The file chooser will
continue running, so as to let the user select another file name.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="GTK-FILE-CHOOSER-ERROR:CAPS"></a><h3>GTK_FILE_CHOOSER_ERROR</h3>
<pre class="programlisting">#define GTK_FILE_CHOOSER_ERROR (gtk_file_chooser_error_quark ())
</pre>
<p>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.</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkFileChooserError"></a><h3>enum GtkFileChooserError</h3>
<p>These identify the various errors that can occur while calling
<a class="link" href="GtkFileChooser.html" title="GtkFileChooser"><span class="type">GtkFileChooser</span></a> functions.</p>
<div class="refsect3">
<a name="GtkFileChooserError.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ERROR-NONEXISTENT:CAPS"></a>GTK_FILE_CHOOSER_ERROR_NONEXISTENT</p></td>
<td class="enum_member_description">
<p>Indicates that a file does not exist.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ERROR-BAD-FILENAME:CAPS"></a>GTK_FILE_CHOOSER_ERROR_BAD_FILENAME</p></td>
<td class="enum_member_description">
<p>Indicates a malformed filename.</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ERROR-ALREADY-EXISTS:CAPS"></a>GTK_FILE_CHOOSER_ERROR_ALREADY_EXISTS</p></td>
<td class="enum_member_description">
<p>Indicates a duplicate path (e.g. when
adding a bookmark).</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GTK-FILE-CHOOSER-ERROR-INCOMPLETE-HOSTNAME:CAPS"></a>GTK_FILE_CHOOSER_ERROR_INCOMPLETE_HOSTNAME</p></td>
<td class="enum_member_description">
<p>Indicates an incomplete hostname (e.g. "http://foo" without a slash after that).</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="refsect1">
<a name="GtkFileChooser.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GtkFileChooser--action"></a><h3>The <code class="literal">“action”</code> property</h3>
<pre class="programlisting"> “action” <a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GtkFileChooserAction"><span class="type">GtkFileChooserAction</span></a></pre>
<pre class="programlisting"> “action” <a class="link" href="GtkFileChooser.html#GtkFileChooserAction" title="enum GtkFileChooserAction"><span class="type">GtkFileChooserAction</span></a></pre>
<p>The type of operation that the file selector is performing.</p>
<p>Owner: GtkFileChooser</p>
<p>Flags: Read / Write</p>
@ -3273,7 +3433,7 @@ directory, does not exist, or is otherwise not currently selected, does nothing.
<div class="refsect2">
<a name="GtkFileChooser--create-folders"></a><h3>The <code class="literal">“create-folders”</code> property</h3>
<pre class="programlisting"> “create-folders” <span class="type">gboolean</span></pre>
<p>Whether a file chooser not in <a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-OPEN:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_OPEN</code></a> mode
<p>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
will offer the user to create new folders.</p>
<p>Owner: GtkFileChooser</p>
<p>Flags: Read / Write</p>
@ -3284,7 +3444,7 @@ will offer the user to create new folders.</p>
<div class="refsect2">
<a name="GtkFileChooser--do-overwrite-confirmation"></a><h3>The <code class="literal">“do-overwrite-confirmation”</code> property</h3>
<pre class="programlisting"> “do-overwrite-confirmation” <span class="type">gboolean</span></pre>
<p>Whether a file chooser in <a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> mode
<p>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 an overwrite confirmation dialog if the user
selects a file name that already exists.</p>
<p>Owner: GtkFileChooser</p>
@ -3366,13 +3526,13 @@ selects a file name that already exists.</p>
<a name="GtkFileChooser.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2">
<a name="GtkFileChooser-confirm-overwrite"></a><h3>The <code class="literal">“confirm-overwrite”</code> signal</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GtkFileChooserConfirmation"><span class="returnvalue">GtkFileChooserConfirmation</span></a>
<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,
<span class="type">gpointer</span> user_data)</pre>
<p>This signal gets emitted whenever it is appropriate to present a
confirmation dialog when the user has selected a file name that
already exists. The signal only gets emitted when the file
chooser is in <a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> mode.</p>
chooser is in <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-ACTION-SAVE:CAPS"><code class="literal">GTK_FILE_CHOOSER_ACTION_SAVE</code></a> mode.</p>
<p>Most applications just need to turn on the
<a class="link" href="GtkFileChooser.html#GtkFileChooser--do-overwrite-confirmation" title="The “do-overwrite-confirmation” property"><span class="type">“do-overwrite-confirmation”</span></a> property (or call the
<a class="link" href="GtkFileChooser.html#gtk-file-chooser-set-do-overwrite-confirmation" title="gtk_file_chooser_set_do_overwrite_confirmation ()"><code class="function">gtk_file_chooser_set_do_overwrite_confirmation()</code></a> function), and
@ -3381,15 +3541,15 @@ Applications which need to customize this behavior should do
that, and also connect to the <a class="link" href="GtkFileChooser.html#GtkFileChooser-confirm-overwrite" title="The “confirm-overwrite” signal"><span class="type">“confirm-overwrite”</span></a>
signal.</p>
<p>A signal handler for this signal must return a
<a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GtkFileChooserConfirmation"><span class="type">GtkFileChooserConfirmation</span></a> value, which indicates the action to
<a class="link" href="GtkFileChooser.html#GtkFileChooserConfirmation" title="enum GtkFileChooserConfirmation"><span class="type">GtkFileChooserConfirmation</span></a> value, which indicates the action to
take. If the handler determines that the user wants to select a
different filename, it should return
<a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GTK-FILE-CHOOSER-CONFIRMATION-SELECT-AGAIN:CAPS"><code class="literal">GTK_FILE_CHOOSER_CONFIRMATION_SELECT_AGAIN</code></a>. If it determines
<a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-CONFIRMATION-SELECT-AGAIN:CAPS"><code class="literal">GTK_FILE_CHOOSER_CONFIRMATION_SELECT_AGAIN</code></a>. If it determines
that the user is satisfied with his choice of file name, it
should return <a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GTK-FILE-CHOOSER-CONFIRMATION-ACCEPT-FILENAME:CAPS"><code class="literal">GTK_FILE_CHOOSER_CONFIRMATION_ACCEPT_FILENAME</code></a>.
should return <a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-CONFIRMATION-ACCEPT-FILENAME:CAPS"><code class="literal">GTK_FILE_CHOOSER_CONFIRMATION_ACCEPT_FILENAME</code></a>.
On the other hand, if it determines that the stock confirmation
dialog should be used, it should return
<a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GTK-FILE-CHOOSER-CONFIRMATION-CONFIRM:CAPS"><code class="literal">GTK_FILE_CHOOSER_CONFIRMATION_CONFIRM</code></a>. The following example
<a class="link" href="GtkFileChooser.html#GTK-FILE-CHOOSER-CONFIRMATION-CONFIRM:CAPS"><code class="literal">GTK_FILE_CHOOSER_CONFIRMATION_CONFIRM</code></a>. The following example
illustrates this.</p>
<div class="refsect3">
<a name="gtkfilechooser-confirmation"></a><h4>Custom confirmation</h4>
@ -3486,7 +3646,7 @@ illustrates this.</p>
</div>
<div class="refsect3">
<a name="GtkFileChooser-confirm-overwrite.returns"></a><h4>Returns</h4>
<p> a <a href="https://developer.gnome.org/gtk4/GtkFileChooser.html#GtkFileChooserConfirmation"><span class="type">GtkFileChooserConfirmation</span></a> value that indicates which
<p> a <a class="link" href="GtkFileChooser.html#GtkFileChooserConfirmation" title="enum GtkFileChooserConfirmation"><span class="type">GtkFileChooserConfirmation</span></a> value that indicates which
action to take after emitting the signal.</p>
</div>
<p>Flags: Run Last</p>