:right-sidebar: True

FileChooserWidget
===================================================================

.. currentmodule:: gi.repository.Gtk





.. deprecated:: 4.10

   Direct use of ``GtkFileChooserWidget`` is deprecated


.. class:: FileChooserWidget(**properties: ~typing.Any)
   :no-contents-entry:


Superclasses: :class:`~gi.repository.Gtk.Widget`, :class:`~gi.repository.GObject.InitiallyUnowned`, :class:`~gi.repository.GObject.Object`



Implemented Interfaces: :class:`~gi.repository.Gtk.Accessible`, :class:`~gi.repository.Gtk.Buildable`, :class:`~gi.repository.Gtk.ConstraintTarget`, :class:`~gi.repository.Gtk.FileChooser`



``GtkFileChooserWidget`` is a widget for choosing files.

It exposes the :obj:`~gi.repository.Gtk.FileChooser` interface, and you should
use the methods of this interface to interact with the
widget.

Shortcuts and Gestures
--------------------------------------------------------------------------------

``GtkFileChooserWidget`` supports the following keyboard shortcuts:

- :kbd:`Shift`\+:kbd:`F10` or :kbd:`Menu` opens the context menu.


The following signals have default keybindings:

- :obj:`~gi.repository.Gtk.FileChooserWidget.signals.desktop_folder`
- :obj:`~gi.repository.Gtk.FileChooserWidget.signals.down_folder`
- :obj:`~gi.repository.Gtk.FileChooserWidget.signals.home_folder`
- :obj:`~gi.repository.Gtk.FileChooserWidget.signals.location_popup`
- :obj:`~gi.repository.Gtk.FileChooserWidget.signals.location_popup_on_paste`
- :obj:`~gi.repository.Gtk.FileChooserWidget.signals.location_toggle_popup`
- :obj:`~gi.repository.Gtk.FileChooserWidget.signals.places_shortcut`
- :obj:`~gi.repository.Gtk.FileChooserWidget.signals.quick_bookmark`
- :obj:`~gi.repository.Gtk.FileChooserWidget.signals.recent_shortcut`
- :obj:`~gi.repository.Gtk.FileChooserWidget.signals.search_shortcut`
- :obj:`~gi.repository.Gtk.FileChooserWidget.signals.show_hidden`
- :obj:`~gi.repository.Gtk.FileChooserWidget.signals.up_folder`


CSS nodes
--------------------------------------------------------------------------------

``GtkFileChooserWidget`` has a single CSS node with name filechooser.


Constructors
------------

.. rst-class:: interim-class

.. class:: FileChooserWidget
   :no-index:


   .. classmethod:: new(action: ~gi.repository.Gtk.FileChooserAction) -> ~gi.repository.Gtk.Widget

      Creates a new ``GtkFileChooserWidget``\.

      This is a file chooser widget that can be embedded in custom
      windows, and it is the same widget that is used by
      ``GtkFileChooserDialog``\.





      .. deprecated:: 4.10

         Direct use of ``GtkFileChooserWidget`` is deprecated



      :param action: Open or save mode for the widget










Properties
----------

.. rst-class:: interim-class

.. class:: FileChooserWidget
   :no-index:
   

   .. attribute:: props.search_mode
      :type: bool

      The type of the None singleton.







   .. attribute:: props.show_time
      :type: bool

      The type of the None singleton.



      .. versionadded:: 4.10





   .. attribute:: props.subtitle
      :type: str

      The type of the None singleton.











Signals
-------

.. rst-class:: interim-class

.. class:: FileChooserWidget.signals
   :no-index:
   

   .. method:: desktop_folder() -> None

      The type of the None singleton.










   .. method:: down_folder() -> None

      The type of the None singleton.










   .. method:: home_folder() -> None

      The type of the None singleton.










   .. method:: location_popup(path: str) -> None

      The type of the None singleton.







      :param path: a string that gets put in the text entry for the file name




   .. method:: location_popup_on_paste() -> None

      The type of the None singleton.










   .. method:: location_toggle_popup() -> None

      The type of the None singleton.










   .. method:: places_shortcut() -> None

      The type of the None singleton.










   .. method:: quick_bookmark(bookmark_index: int) -> None

      The type of the None singleton.







      :param bookmark_index: the number of the bookmark to switch to




   .. method:: recent_shortcut() -> None

      The type of the None singleton.










   .. method:: search_shortcut() -> None

      The type of the None singleton.










   .. method:: show_hidden() -> None

      The type of the None singleton.










   .. method:: up_folder() -> None

      The type of the None singleton.