Skip to content

Gtk.WindowGroup

class — extends GObject.Object

Creates groups of windows that behave like separate applications.

It achieves this by limiting the effect of GTK grabs and modality to windows in the same group.

A window can be a member in at most one window group at a time. Windows that have not been explicitly assigned to a group are implicitly treated like windows of the default window group.

GtkWindowGroup objects are referenced by each window in the group, so once you have added all windows to a GtkWindowGroup, you can drop the initial reference to the window group with GObject.Object.unref. If the windows in the window group are subsequently destroyed, then they will be removed from the window group and drop their references on the window group; when all window have been removed, the window group will be freed.

Constructors

new

@classmethod
def new(cls) -> WindowGroup

Creates a new GtkWindowGroup object.

Modality of windows only affects windows within the same GtkWindowGroup.

Methods

add_window

def add_window(self, window: Window) -> None

Adds a window to a GtkWindowGroup.

Parameters:

  • window — the GtkWindow to add

list_windows

def list_windows(self) -> list[Window]

Returns a list of the GtkWindows that belong to window_group.

remove_window

def remove_window(self, window: Window) -> None

Removes a window from a GtkWindowGroup.

Parameters:

  • window — the GtkWindow to remove