:right-sidebar: True

WindowHandle
===================================================================

.. currentmodule:: gi.repository.Gtk





.. class:: WindowHandle(**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`



``GtkWindowHandle`` is a titlebar area widget.

When added into a window, it can be dragged to move the window, and handles
right click, double click and middle click as expected of a titlebar.

CSS nodes
---------

``GtkWindowHandle`` has a single CSS node with the name ``windowhandle``.

Accessibility
-------------

Until GTK 4.10, ``GtkWindowHandle`` used the ``GTK_ACCESSIBLE_ROLE_GROUP`` role.

Starting from GTK 4.12, ``GtkWindowHandle`` uses the ``GTK_ACCESSIBLE_ROLE_GENERIC`` role.



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

.. rst-class:: interim-class

.. class:: WindowHandle
   :no-index:


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

      Creates a new ``GtkWindowHandle``.














Methods
-------

.. rst-class:: interim-class

.. class:: WindowHandle
   :no-index:


   .. method:: get_child() -> ~gi.repository.Gtk.Widget | None

      Gets the child widget of ``self``.










   .. method:: set_child(child: ~gi.repository.Gtk.Widget | None = None) -> None

      Sets the child widget of ``self``.







      :param child: the child widget









Properties
----------

.. rst-class:: interim-class

.. class:: WindowHandle
   :no-index:
   

   .. attribute:: props.child
      :type: ~gi.repository.Gtk.Widget

      The child widget.