<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
<!ENTITY pi "&#960;">
<!ENTITY solidus "&#8260;">
]>
<refentry id="GtkFileChooserWidget">
<refmeta>
<refentrytitle role="top_of_page" id="GtkFileChooserWidget.top_of_page">GtkFileChooserWidget</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK4 Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GtkFileChooserWidget</refname>
<refpurpose>A file chooser widget</refpurpose>
</refnamediv>

<refsect1 id="GtkFileChooserWidget.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_proto_type" colwidth="150px"/>
<colspec colname="functions_proto_name"/>
<tbody>
<row><entry role="function_type"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="gtk-file-chooser-widget-new">gtk_file_chooser_widget_new</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkFileChooserWidget.properties" role="properties">
<title role="properties.title">Properties</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="properties_type" colwidth="150px"/>
<colspec colname="properties_name" colwidth="300px"/>
<colspec colname="properties_flags" colwidth="200px"/>
<tbody>
<row><entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry><entry role="property_name"><link linkend="GtkFileChooserWidget--search-mode">search-mode</link></entry><entry role="property_flags">Read / Write</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="GtkFileChooserWidget--subtitle">subtitle</link></entry><entry role="property_flags">Read</entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkFileChooserWidget.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="signal_proto_type" colwidth="150px"/>
<colspec colname="signal_proto_name" colwidth="300px"/>
<colspec colname="signal_proto_flags" colwidth="200px"/>
<tbody>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkFileChooserWidget-desktop-folder">desktop-folder</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-ACTION:CAPS">Action</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkFileChooserWidget-down-folder">down-folder</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-ACTION:CAPS">Action</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkFileChooserWidget-home-folder">home-folder</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-ACTION:CAPS">Action</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkFileChooserWidget-location-popup">location-popup</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-ACTION:CAPS">Action</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkFileChooserWidget-location-popup-on-paste">location-popup-on-paste</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-ACTION:CAPS">Action</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkFileChooserWidget-location-toggle-popup">location-toggle-popup</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-ACTION:CAPS">Action</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkFileChooserWidget-places-shortcut">places-shortcut</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-ACTION:CAPS">Action</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkFileChooserWidget-quick-bookmark">quick-bookmark</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-ACTION:CAPS">Action</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkFileChooserWidget-recent-shortcut">recent-shortcut</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-ACTION:CAPS">Action</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkFileChooserWidget-search-shortcut">search-shortcut</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-ACTION:CAPS">Action</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkFileChooserWidget-show-hidden">show-hidden</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-ACTION:CAPS">Action</link></entry></row>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="GtkFileChooserWidget-up-folder">up-folder</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-ACTION:CAPS">Action</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkFileChooserWidget.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="other_proto_type" colwidth="150px"/>
<colspec colname="other_proto_name"/>
<tbody>
<row><entry role="datatype_keyword"></entry><entry role="function_name"><link linkend="GtkFileChooserWidget-struct">GtkFileChooserWidget</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="GtkFileChooserWidget.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<screen>    <link linkend="GObject">GObject</link>
    <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
        <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="GtkWidget">GtkWidget</link>
            <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> GtkFileChooserWidget
</screen>
</refsect1>
<refsect1 id="GtkFileChooserWidget.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkFileChooserWidget implements
 <link linkend="AtkImplementorIface">AtkImplementorIface</link>,  <link linkend="GtkBuildable">GtkBuildable</link>,  <link linkend="GtkConstraintTarget">GtkConstraintTarget</link>,  <link linkend="GtkFileChooser">GtkFileChooser</link> and  <link linkend="GtkFileChooserEmbed">GtkFileChooserEmbed</link>.</para>

</refsect1>

<refsect1 id="GtkFileChooserWidget.includes"><title>Includes</title><synopsis>#include &lt;gtk/gtk.h&gt;
</synopsis></refsect1>

<refsect1 id="GtkFileChooserWidget.description" role="desc">
<title role="desc.title">Description</title>
<para><link linkend="GtkFileChooserWidget"><type>GtkFileChooserWidget</type></link> is a widget for choosing files.
It exposes the <link linkend="GtkFileChooser"><type>GtkFileChooser</type></link> interface, and you should
use the methods of this interface to interact with the
widget.</para>
<refsect2><title>CSS nodes</title><para>GtkFileChooserWidget has a single CSS node with name filechooser.</para>
</refsect2>

</refsect1>
<refsect1 id="GtkFileChooserWidget.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="gtk-file-chooser-widget-new" role="function">
<title>gtk_file_chooser_widget_new&#160;()</title>
<indexterm zone="gtk-file-chooser-widget-new"><primary>gtk_file_chooser_widget_new</primary></indexterm>
<programlisting language="C"><link linkend="GtkWidget"><returnvalue>GtkWidget</returnvalue></link>&#160;*
gtk_file_chooser_widget_new (<parameter><link linkend="GtkFileChooserAction"><type>GtkFileChooserAction</type></link> action</parameter>);</programlisting>
<para>Creates a new <link linkend="GtkFileChooserWidget"><type>GtkFileChooserWidget</type></link>. This is a file chooser widget that can
be embedded in custom windows, and it is the same widget that is used by
<link linkend="GtkFileChooserDialog"><type>GtkFileChooserDialog</type></link>.</para>
<refsect3 id="gtk-file-chooser-widget-new.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>action</para></entry>
<entry role="parameter_description"><para>Open or save mode for the widget</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="gtk-file-chooser-widget-new.returns" role="returns">
<title>Returns</title>
<para> a new <link linkend="GtkFileChooserWidget"><type>GtkFileChooserWidget</type></link></para>
</refsect3></refsect2>

</refsect1>
<refsect1 id="GtkFileChooserWidget.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="GtkFileChooserWidget-struct" role="struct">
<title>GtkFileChooserWidget</title>
<indexterm zone="GtkFileChooserWidget-struct"><primary>GtkFileChooserWidget</primary></indexterm>
<programlisting language="C">typedef struct _GtkFileChooserWidget GtkFileChooserWidget;</programlisting>
</refsect2>

</refsect1>
<refsect1 id="GtkFileChooserWidget.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkFileChooserWidget--search-mode" role="property"><title>The <literal>“search-mode”</literal> property</title>
<indexterm zone="GtkFileChooserWidget--search-mode"><primary>GtkFileChooserWidget:search-mode</primary></indexterm>
<programlisting>  “search-mode”              <link linkend="gboolean"><type>gboolean</type></link></programlisting>
<para>Search mode.</para><para>Owner: GtkFileChooserWidget</para>
<para>Flags: Read / Write</para>
<para>Default value: FALSE</para>
</refsect2>
<refsect2 id="GtkFileChooserWidget--subtitle" role="property"><title>The <literal>“subtitle”</literal> property</title>
<indexterm zone="GtkFileChooserWidget--subtitle"><primary>GtkFileChooserWidget:subtitle</primary></indexterm>
<programlisting>  “subtitle”                 <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>Subtitle.</para><para>Owner: GtkFileChooserWidget</para>
<para>Flags: Read</para>
<para>Default value: ""</para>
</refsect2>

</refsect1>
<refsect1 id="GtkFileChooserWidget.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GtkFileChooserWidget-desktop-folder" role="signal"><title>The <literal>“desktop-folder”</literal> signal</title>
<indexterm zone="GtkFileChooserWidget-desktop-folder"><primary>GtkFileChooserWidget::desktop-folder</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkFileChooserWidget"><type>GtkFileChooserWidget</type></link> *widget,
               <link linkend="gpointer"><type>gpointer</type></link>              user_data)</programlisting>
<para>The ::desktop-folder signal is a <link linkend="GtkBindingSignal">keybinding signal</link>
which gets emitted when the user asks for it.</para>
<para>This is used to make the file chooser show the user's Desktop
folder in the file list.</para>
<para>The default binding for this signal is <literal>Alt + D</literal>.</para>
<refsect3 id="GtkFileChooserWidget-desktop-folder.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-ACTION:CAPS">Action</link></para>
</refsect2><refsect2 id="GtkFileChooserWidget-down-folder" role="signal"><title>The <literal>“down-folder”</literal> signal</title>
<indexterm zone="GtkFileChooserWidget-down-folder"><primary>GtkFileChooserWidget::down-folder</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkFileChooserWidget"><type>GtkFileChooserWidget</type></link> *widget,
               <link linkend="gpointer"><type>gpointer</type></link>              user_data)</programlisting>
<para>The ::down-folder signal is a <link linkend="GtkBindingSignal">keybinding signal</link>
which gets emitted when the user asks for it.</para>
<para>This is used to make the file chooser go to a child of the current folder
in the file hierarchy. The subfolder that will be used is displayed in the
path bar widget of the file chooser. For example, if the path bar is showing
"/foo/bar/baz", with bar currently displayed, then this will cause the file
chooser to switch to the "baz" subfolder.</para>
<para>The default binding for this signal is <literal>Alt + Down</literal>.</para>
<refsect3 id="GtkFileChooserWidget-down-folder.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-ACTION:CAPS">Action</link></para>
</refsect2><refsect2 id="GtkFileChooserWidget-home-folder" role="signal"><title>The <literal>“home-folder”</literal> signal</title>
<indexterm zone="GtkFileChooserWidget-home-folder"><primary>GtkFileChooserWidget::home-folder</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkFileChooserWidget"><type>GtkFileChooserWidget</type></link> *widget,
               <link linkend="gpointer"><type>gpointer</type></link>              user_data)</programlisting>
<para>The ::home-folder signal is a <link linkend="GtkBindingSignal">keybinding signal</link>
which gets emitted when the user asks for it.</para>
<para>This is used to make the file chooser show the user's home
folder in the file list.</para>
<para>The default binding for this signal is <literal>Alt + Home</literal>.</para>
<refsect3 id="GtkFileChooserWidget-home-folder.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-ACTION:CAPS">Action</link></para>
</refsect2><refsect2 id="GtkFileChooserWidget-location-popup" role="signal"><title>The <literal>“location-popup”</literal> signal</title>
<indexterm zone="GtkFileChooserWidget-location-popup"><primary>GtkFileChooserWidget::location-popup</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkFileChooserWidget"><type>GtkFileChooserWidget</type></link> *widget,
               <link linkend="gchar"><type>gchar</type></link>                *path,
               <link linkend="gpointer"><type>gpointer</type></link>              user_data)</programlisting>
<para>The ::location-popup signal is a <link linkend="GtkBindingSignal">keybinding signal</link>
which gets emitted when the user asks for it.</para>
<para>This is used to make the file chooser show a "Location" prompt which
the user can use to manually type the name of the file he wishes to select.</para>
<para>The default bindings for this signal are <literal>Control + L</literal> with a <parameter>path</parameter>
 string
of "" (the empty string).  It is also bound to <literal>/</literal> with a <parameter>path</parameter>
 string of
"<literal>/</literal>" (a slash):  this lets you type <literal>/</literal> and immediately type a path name.
On Unix systems, this is bound to <literal>~</literal> (tilde) with a <parameter>path</parameter>
 string of "~"
itself for access to home directories.</para>
<refsect3 id="GtkFileChooserWidget-location-popup.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>path</para></entry>
<entry role="parameter_description"><para>a string that gets put in the text entry for the file name</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-ACTION:CAPS">Action</link></para>
</refsect2><refsect2 id="GtkFileChooserWidget-location-popup-on-paste" role="signal"><title>The <literal>“location-popup-on-paste”</literal> signal</title>
<indexterm zone="GtkFileChooserWidget-location-popup-on-paste"><primary>GtkFileChooserWidget::location-popup-on-paste</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkFileChooserWidget"><type>GtkFileChooserWidget</type></link> *widget,
               <link linkend="gpointer"><type>gpointer</type></link>              user_data)</programlisting>
<para>The ::location-popup-on-paste signal is a <link linkend="GtkBindingSignal">keybinding signal</link>
which gets emitted when the user asks for it.</para>
<para>This is used to make the file chooser show a "Location" prompt when the user
pastes into a <link linkend="GtkFileChooserWidget"><type>GtkFileChooserWidget</type></link>.</para>
<para>The default binding for this signal is <literal>Control + V</literal>.</para>
<refsect3 id="GtkFileChooserWidget-location-popup-on-paste.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-ACTION:CAPS">Action</link></para>
</refsect2><refsect2 id="GtkFileChooserWidget-location-toggle-popup" role="signal"><title>The <literal>“location-toggle-popup”</literal> signal</title>
<indexterm zone="GtkFileChooserWidget-location-toggle-popup"><primary>GtkFileChooserWidget::location-toggle-popup</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkFileChooserWidget"><type>GtkFileChooserWidget</type></link> *widget,
               <link linkend="gpointer"><type>gpointer</type></link>              user_data)</programlisting>
<para>The ::location-toggle-popup signal is a <link linkend="GtkBindingSignal">keybinding signal</link>
which gets emitted when the user asks for it.</para>
<para>This is used to toggle the visibility of a "Location" prompt which the user
can use to manually type the name of the file he wishes to select.</para>
<para>The default binding for this signal is <literal>Control + L</literal>.</para>
<refsect3 id="GtkFileChooserWidget-location-toggle-popup.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-ACTION:CAPS">Action</link></para>
</refsect2><refsect2 id="GtkFileChooserWidget-places-shortcut" role="signal"><title>The <literal>“places-shortcut”</literal> signal</title>
<indexterm zone="GtkFileChooserWidget-places-shortcut"><primary>GtkFileChooserWidget::places-shortcut</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkFileChooserWidget"><type>GtkFileChooserWidget</type></link> *widget,
               <link linkend="gpointer"><type>gpointer</type></link>              user_data)</programlisting>
<para>The ::places-shortcut signal is a <link linkend="GtkBindingSignal">keybinding signal</link>
which gets emitted when the user asks for it.</para>
<para>This is used to move the focus to the places sidebar.</para>
<para>The default binding for this signal is <literal>Alt + P</literal>.</para>
<refsect3 id="GtkFileChooserWidget-places-shortcut.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-ACTION:CAPS">Action</link></para>
</refsect2><refsect2 id="GtkFileChooserWidget-quick-bookmark" role="signal"><title>The <literal>“quick-bookmark”</literal> signal</title>
<indexterm zone="GtkFileChooserWidget-quick-bookmark"><primary>GtkFileChooserWidget::quick-bookmark</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkFileChooserWidget"><type>GtkFileChooserWidget</type></link> *widget,
               <link linkend="gint"><type>gint</type></link>                  bookmark_index,
               <link linkend="gpointer"><type>gpointer</type></link>              user_data)</programlisting>
<para>The ::quick-bookmark signal is a <link linkend="GtkBindingSignal">keybinding signal</link>
which gets emitted when the user asks for it.</para>
<para>This is used to make the file chooser switch to the bookmark specified
in the <parameter>bookmark_index</parameter>
 parameter. For example, if you have three bookmarks,
you can pass 0, 1, 2 to this signal to switch to each of them, respectively.</para>
<para>The default binding for this signal is <literal>Alt + 1</literal>, <literal>Alt + 2</literal>,
etc. until <literal>Alt + 0</literal>.  Note that in the default binding, that
<literal>Alt + 1</literal> is actually defined to switch to the bookmark at index
0, and so on successively; <literal>Alt + 0</literal> is defined to switch to the
bookmark at index 10.</para>
<refsect3 id="GtkFileChooserWidget-quick-bookmark.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>bookmark_index</para></entry>
<entry role="parameter_description"><para>the number of the bookmark to switch to</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-ACTION:CAPS">Action</link></para>
</refsect2><refsect2 id="GtkFileChooserWidget-recent-shortcut" role="signal"><title>The <literal>“recent-shortcut”</literal> signal</title>
<indexterm zone="GtkFileChooserWidget-recent-shortcut"><primary>GtkFileChooserWidget::recent-shortcut</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkFileChooserWidget"><type>GtkFileChooserWidget</type></link> *widget,
               <link linkend="gpointer"><type>gpointer</type></link>              user_data)</programlisting>
<para>The ::recent-shortcut signal is a <link linkend="GtkBindingSignal">keybinding signal</link>
which gets emitted when the user asks for it.</para>
<para>This is used to make the file chooser show the Recent location.</para>
<para>The default binding for this signal is <literal>Alt + R</literal>.</para>
<refsect3 id="GtkFileChooserWidget-recent-shortcut.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-ACTION:CAPS">Action</link></para>
</refsect2><refsect2 id="GtkFileChooserWidget-search-shortcut" role="signal"><title>The <literal>“search-shortcut”</literal> signal</title>
<indexterm zone="GtkFileChooserWidget-search-shortcut"><primary>GtkFileChooserWidget::search-shortcut</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkFileChooserWidget"><type>GtkFileChooserWidget</type></link> *widget,
               <link linkend="gpointer"><type>gpointer</type></link>              user_data)</programlisting>
<para>The ::search-shortcut signal is a <link linkend="GtkBindingSignal">keybinding signal</link>
which gets emitted when the user asks for it.</para>
<para>This is used to make the file chooser show the search entry.</para>
<para>The default binding for this signal is <literal>Alt + S</literal>.</para>
<refsect3 id="GtkFileChooserWidget-search-shortcut.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-ACTION:CAPS">Action</link></para>
</refsect2><refsect2 id="GtkFileChooserWidget-show-hidden" role="signal"><title>The <literal>“show-hidden”</literal> signal</title>
<indexterm zone="GtkFileChooserWidget-show-hidden"><primary>GtkFileChooserWidget::show-hidden</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkFileChooserWidget"><type>GtkFileChooserWidget</type></link> *widget,
               <link linkend="gpointer"><type>gpointer</type></link>              user_data)</programlisting>
<para>The ::show-hidden signal is a <link linkend="GtkBindingSignal">keybinding signal</link>
which gets emitted when the user asks for it.</para>
<para>This is used to make the file chooser display hidden files.</para>
<para>The default binding for this signal is <literal>Control + H</literal>.</para>
<refsect3 id="GtkFileChooserWidget-show-hidden.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-ACTION:CAPS">Action</link></para>
</refsect2><refsect2 id="GtkFileChooserWidget-up-folder" role="signal"><title>The <literal>“up-folder”</literal> signal</title>
<indexterm zone="GtkFileChooserWidget-up-folder"><primary>GtkFileChooserWidget::up-folder</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="GtkFileChooserWidget"><type>GtkFileChooserWidget</type></link> *widget,
               <link linkend="gpointer"><type>gpointer</type></link>              user_data)</programlisting>
<para>The ::up-folder signal is a <link linkend="GtkBindingSignal">keybinding signal</link>
which gets emitted when the user asks for it.</para>
<para>This is used to make the file chooser go to the parent of the current folder
in the file hierarchy.</para>
<para>The default binding for this signal is <literal>Alt + Up</literal>.</para>
<refsect3 id="GtkFileChooserWidget-up-folder.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>widget</para></entry>
<entry role="parameter_description"><para>the object which received the signal</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-ACTION:CAPS">Action</link></para>
</refsect2>
</refsect1>
<refsect1 id="GtkFileChooserWidget.see-also">
<title>See Also</title>
<para><link linkend="GtkFileChooserDialog"><type>GtkFileChooserDialog</type></link></para>

</refsect1>

</refentry>
