Gdk.ToplevelSize¶

record (struct)

Contains information that is useful to compute the size of a toplevel.

Methods¶

get_bounds¶

def get_bounds(self) -> 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.

set_min_size¶

def set_min_size(self, 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 ToplevelSize.get_bounds).

Parameters:

min_width — the minimum width
min_height — the minimum height

set_shadow_width¶

def set_shadow_width(self, 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 Gtk.Display.supports_shadow_width is True.

Parameters:

left — width of the left part of the shadow
right — width of the right part of the shadow
top — height of the top part of the shadow
bottom — height of the bottom part of the shadow

set_size¶

def set_size(self, width: int, height: int) -> None

Sets the size the toplevel prefers to be resized to.

The size should be within the bounds (see 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.

Parameters:

width — the width
height — the height