:right-sidebar: True

ToplevelSize
===================================================================

.. currentmodule:: gi.repository.Gdk





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






The ``GdkToplevelSize`` struct contains information that is useful
to compute the size of a toplevel.




Methods
-------

.. rst-class:: interim-class

.. class:: ToplevelSize
   :no-index:


   .. method:: get_bounds() -> ~typing.Tuple[int, int]

      Retrieves the bounds the toplevel is placed within.

      The bounds represent the largest size a toplevel may have while still being
      able to fit within some type of boundary. Depending on the backend, this may
      be equivalent to the dimensions of the work area or the monitor on which the
      window is being presented on, or something else that limits the way a
      toplevel can be presented.









   .. method:: set_min_size(min_width: int, min_height: int) -> None

      Sets the minimum size of the toplevel.

      The minimum size corresponds to the limitations the toplevel can be shrunk
      to, without resulting in incorrect painting. A user of a ``GdkToplevel`` should
      calculate these given both the existing size, and the bounds retrieved from
      the ``GdkToplevelSize`` object.

      The minimum size should be within the bounds (see
      :obj:`~gi.repository.Gdk.ToplevelSize.get_bounds`\).






      :param min_width: the minimum width

      :param min_height: the minimum height




   .. method:: set_shadow_width(left: int, right: int, top: int, bottom: int) -> None

      Sets the shadows size of the toplevel.

      The shadow width corresponds to the part of the computed surface size
      that would consist of the shadow margin surrounding the window, would
      there be any.

      Shadow width should only be set if
      :obj:`~gi.repository.Gtk.Display.supports_shadow_width` is :const:`True`.






      :param left: width of the left part of the shadow

      :param right: width of the right part of the shadow

      :param top: height of the top part of the shadow

      :param bottom: height of the bottom part of the shadow




   .. method:: set_size(width: int, height: int) -> None

      Sets the size the toplevel prefers to be resized to.

      The size should be within the bounds (see
      :obj:`~gi.repository.Gdk.ToplevelSize.get_bounds`\). The set size should
      be considered as a hint, and should not be assumed to be
      respected by the windowing system, or backend.






      :param width: the width

      :param height: the height