Gtk.WindowGroup¶

Subclasses:	None

Methods¶

Inherited:	GObject.Object (37)
Structs:	GObject.ObjectClass (5)

class	`new` ()
	`add_window` (window)
	`get_current_device_grab` (device)
	`get_current_grab` ()
	`list_windows` ()
	`remove_window` (window)

Virtual Methods¶

Inherited:	GObject.Object (7)

Properties¶

None

Signals¶

Inherited:	GObject.Object (1)

Fields¶

Inherited:	GObject.Object (1)

Name	Type	Access	Description
parent_instance	`GObject.Object`	r

Class Details¶

class Gtk.WindowGroup(**kwargs)¶

Bases:	`GObject.Object`
Abstract:	No
Structure:	`Gtk.WindowGroupClass`

A Gtk.WindowGroup restricts the effect of grabs to windows in the same group, thereby making window groups almost behave like separate applications.

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.

Gtk.WindowGroup objects are referenced by each window in the group, so once you have added all windows to a Gtk.WindowGroup, 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.

classmethod new()[source]¶

Returns:	a new `Gtk.WindowGroup`.
Return type:	`Gtk.WindowGroup`

Creates a new Gtk.WindowGroup object. Grabs added with Gtk.Widget.grab_add() only affect windows within the same Gtk.WindowGroup.

add_window(window)[source]¶

Parameters:	window (`Gtk.Window`) – the `Gtk.Window` to add

Adds a window to a Gtk.WindowGroup.

get_current_device_grab(device)[source]¶

Parameters:	device (`Gdk.Device`) – a `Gdk.Device`
Returns:	The grab widget, or `None`
Return type:	`Gtk.Widget` or `None`

Returns the current grab widget for device, or None if none.

New in version 3.0.

get_current_grab()[source]¶

Returns:	the current grab widget of the group
Return type:	`Gtk.Widget`

Gets the current grab widget of the given group, see Gtk.Widget.grab_add().

New in version 2.22.

list_windows()[source]¶

Returns:	A newly-allocated list of windows inside the group.
Return type:	[`Gtk.Window`]

Returns a list of the Gtk.Windows that belong to self.

New in version 2.14.

remove_window(window)[source]¶

Parameters:	window (`Gtk.Window`) – the `Gtk.Window` to remove

Removes a window from a Gtk.WindowGroup.