:right-sidebar: True

ShortcutsWindow
===================================================================

.. currentmodule:: gi.repository.Gtk





.. class:: ShortcutsWindow(*args, **kwargs)
   :no-contents-entry:


Superclasses: :class:`~gi.repository.Gtk.Window`, :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.Native`, :class:`~gi.repository.Gtk.Root`, :class:`~gi.repository.Gtk.ShortcutManager`



:Constructors:

::

    ShortcutsWindow(**properties)





Methods
-------

.. rst-class:: interim-class

.. class:: ShortcutsWindow
   :no-index:


   .. method:: add_section(section: ~gi.repository.Gtk.ShortcutsSection) -> None

      Adds a section to the shortcuts window.

      This is the programmatic equivalent to using :obj:`~gi.repository.Gtk.Builder` and a
      ``<child>`` tag to add the child.

      Using :obj:`~gi.repository.Gtk.Window.set_child` is not appropriate as the shortcuts
      window manages its children internally.



      .. versionadded:: 4.14





      :param section: the ``GtkShortcutsSection`` to add









Properties
----------

.. rst-class:: interim-class

.. class:: ShortcutsWindow
   :no-index:
   

   .. attribute:: props.section_name
      :type: str

      The name of the section to show.

      This should be the section-name of one of the ``GtkShortcutsSection``
      objects that are in this shortcuts window.







   .. attribute:: props.view_name
      :type: str

      The view name by which to filter the contents.

      This should correspond to the :obj:`~gi.repository.Gtk.ShortcutsGroup.props.view`
      property of some of the :obj:`~gi.repository.Gtk.ShortcutsGroup` objects that
      are inside this shortcuts window.

      Set this to :const:`None` to show all groups.











Signals
-------

.. rst-class:: interim-class

.. class:: ShortcutsWindow.signals
   :no-index:
   

   .. method:: close() -> None

      Emitted when the user uses a keybinding to close the window.

      This is a `keybinding signal <class.SignalAction.html>`_.

      The default binding for this signal is the Escape key.










   .. method:: search() -> None

      Emitted when the user uses a keybinding to start a search.

      This is a `keybinding signal <class.SignalAction.html>`_.

      The default binding for this signal is Control-F.