:right-sidebar: True

Paned
===================================================================

.. currentmodule:: gi.repository.Gtk





.. class:: Paned(**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.AccessibleRange`, :class:`~gi.repository.Gtk.Buildable`, :class:`~gi.repository.Gtk.ConstraintTarget`, :class:`~gi.repository.Gtk.Orientable`



A widget with two panes, arranged either horizontally or vertically.


.. image:: https://docs.gtk.org/gtk4/panes.png


The division between the two panes is adjustable by the user
by dragging a handle.

Child widgets are added to the panes of the widget with
:obj:`~gi.repository.Gtk.Paned.set_start_child` and :obj:`~gi.repository.Gtk.Paned.set_end_child`.
The division between the two children is set by default from the size
requests of the children, but it can be adjusted by the user.

A paned widget draws a separator between the two child widgets and a
small handle that the user can drag to adjust the division. It does not
draw any relief around the children or around the separator. (The space
in which the separator is called the gutter.) Often, it is useful to put
each child inside a :obj:`~gi.repository.Gtk.Frame` so that the gutter appears as a
ridge. No separator is drawn if one of the children is missing.

Each child has two options that can be set, "resize" and "shrink". If
"resize" is true then, when the ``GtkPaned`` is resized, that child will
expand or shrink along with the paned widget. If "shrink" is true, then
that child can be made smaller than its requisition by the user.
Setting "shrink" to false allows the application to set a minimum size.
If "resize" is false for both children, then this is treated as if
"resize" is true for both children.

The application can set the position of the slider as if it were set
by the user, by calling :obj:`~gi.repository.Gtk.Paned.set_position`.

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

The following signals have default keybindings:


- :obj:`~gi.repository.Gtk.Paned.signals.accept_position`
- :obj:`~gi.repository.Gtk.Paned.signals.cancel_position`
- :obj:`~gi.repository.Gtk.Paned.signals.cycle_child_focus`
- :obj:`~gi.repository.Gtk.Paned.signals.cycle_handle_focus`
- :obj:`~gi.repository.Gtk.Paned.signals.move_handle`
- :obj:`~gi.repository.Gtk.Paned.signals.toggle_handle_focus`

CSS nodes
---------


.. code-block:: 
   :dedent:

   paned
   ├── <child>
   ├── separator[.wide]
   ╰── <child>


``GtkPaned`` has a main CSS node with name paned, and a subnode for
the separator with name separator. The subnode gets a .wide style
class when the paned is supposed to be wide.

In horizontal orientation, the nodes are arranged based on the text
direction, so in left-to-right mode, :first-child will select the
leftmost child, while it will select the rightmost child in
RTL layouts.

Creating a paned widget with minimum sizes.
-------------------------------------------


.. code-block:: c
   :dedent:

   GtkWidget *hpaned = gtk_paned_new (GTK_ORIENTATION_HORIZONTAL);
   GtkWidget *frame1 = gtk_frame_new (NULL);
   GtkWidget *frame2 = gtk_frame_new (NULL);
   
   gtk_widget_set_size_request (hpaned, 200, -1);
   
   gtk_paned_set_start_child (GTK_PANED (hpaned), frame1);
   gtk_paned_set_resize_start_child (GTK_PANED (hpaned), TRUE);
   gtk_paned_set_shrink_start_child (GTK_PANED (hpaned), FALSE);
   gtk_widget_set_size_request (frame1, 50, -1);
   
   gtk_paned_set_end_child (GTK_PANED (hpaned), frame2);
   gtk_paned_set_resize_end_child (GTK_PANED (hpaned), FALSE);
   gtk_paned_set_shrink_end_child (GTK_PANED (hpaned), FALSE);
   gtk_widget_set_size_request (frame2, 50, -1);




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

.. rst-class:: interim-class

.. class:: Paned
   :no-index:


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

      Creates a new ``GtkPaned`` widget.







      :param orientation: the paned’s orientation.









Methods
-------

.. rst-class:: interim-class

.. class:: Paned
   :no-index:


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

      Retrieves the end child of the given ``GtkPaned``.










   .. method:: get_position() -> int

      Obtains the position of the divider between the two panes.










   .. method:: get_resize_end_child() -> bool

      Returns whether the :obj:`~gi.repository.Gtk.Paned.props.end_child` can be resized.










   .. method:: get_resize_start_child() -> bool

      Returns whether the :obj:`~gi.repository.Gtk.Paned.props.start_child` can be resized.










   .. method:: get_shrink_end_child() -> bool

      Returns whether the :obj:`~gi.repository.Gtk.Paned.props.end_child` can shrink.










   .. method:: get_shrink_start_child() -> bool

      Returns whether the :obj:`~gi.repository.Gtk.Paned.props.start_child` can shrink.










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

      Retrieves the start child of the given ``GtkPaned``.










   .. method:: get_wide_handle() -> bool

      Gets whether the separator should be wide.










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

      Sets the end child of ``paned`` to ``child``.

      If ``child`` is ``NULL``, the existing child will be removed.







      :param child: the widget to add





   .. method:: set_position(position: int) -> None

      Sets the position of the divider between the two panes.







      :param position: pixel position of divider, a negative value means that the position
         is unset





   .. method:: set_resize_end_child(resize: bool) -> None

      Sets whether the :obj:`~gi.repository.Gtk.Paned.props.end_child` can be resized.







      :param resize: true to let the end child be resized





   .. method:: set_resize_start_child(resize: bool) -> None

      Sets whether the :obj:`~gi.repository.Gtk.Paned.props.start_child` can be resized.







      :param resize: true to let the start child be resized





   .. method:: set_shrink_end_child(resize: bool) -> None

      Sets whether the :obj:`~gi.repository.Gtk.Paned.props.end_child` can shrink.







      :param resize: true to let the end child be shrunk





   .. method:: set_shrink_start_child(resize: bool) -> None

      Sets whether the :obj:`~gi.repository.Gtk.Paned.props.start_child` can shrink.







      :param resize: true to let the start child be shrunk





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

      Sets the start child of ``paned`` to ``child``.

      If ``child`` is ``NULL``, the existing child will be removed.







      :param child: the widget to add





   .. method:: set_wide_handle(wide: bool) -> None

      Sets whether the separator should be wide.







      :param wide: the new value for the :obj:`~gi.repository.Gtk.Paned.props.wide_handle` property









Properties
----------

.. rst-class:: interim-class

.. class:: Paned
   :no-index:
   

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

      The type of the None singleton.







   .. attribute:: props.max_position
      :type: int

      The type of the None singleton.







   .. attribute:: props.min_position
      :type: int

      The type of the None singleton.







   .. attribute:: props.position
      :type: int

      The type of the None singleton.







   .. attribute:: props.position_set
      :type: bool

      The type of the None singleton.







   .. attribute:: props.resize_end_child
      :type: bool

      The type of the None singleton.







   .. attribute:: props.resize_start_child
      :type: bool

      The type of the None singleton.







   .. attribute:: props.shrink_end_child
      :type: bool

      The type of the None singleton.







   .. attribute:: props.shrink_start_child
      :type: bool

      The type of the None singleton.







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

      The type of the None singleton.







   .. attribute:: props.wide_handle
      :type: bool

      The type of the None singleton.











Signals
-------

.. rst-class:: interim-class

.. class:: Paned.signals
   :no-index:
   

   .. method:: accept_position() -> bool

      The type of the None singleton.










   .. method:: cancel_position() -> bool

      The type of the None singleton.










   .. method:: cycle_child_focus(reversed: bool) -> bool

      The type of the None singleton.







      :param reversed: whether cycling backward or forward





   .. method:: cycle_handle_focus(reversed: bool) -> bool

      The type of the None singleton.







      :param reversed: whether cycling backward or forward





   .. method:: move_handle(scroll_type: ~gi.repository.Gtk.ScrollType) -> bool

      The type of the None singleton.







      :param scroll_type: a ``GtkScrollType``





   .. method:: toggle_handle_focus() -> bool

      The type of the None singleton.