gi-gtk-4.0.5: Gtk bindings
CopyrightWill Thompson and Iñaki García Etxebarria
LicenseLGPL-2.1
MaintainerIñaki García Etxebarria
Safe HaskellSafe-Inferred
LanguageHaskell2010

GI.Gtk.Objects.WindowGroup

Description

GtkWindowGroup makes group of windows 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 objectUnref. 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.

Synopsis

Exported types

newtype WindowGroup Source #

Memory-managed wrapper type.

class (GObject o, IsDescendantOf WindowGroup o) => IsWindowGroup o Source #

Type class for types which can be safely cast to WindowGroup, for instance with toWindowGroup.

Instances

Instances details
(GObject o, IsDescendantOf WindowGroup o) => IsWindowGroup o Source # 
Instance details

Defined in GI.Gtk.Objects.WindowGroup

toWindowGroup :: (MonadIO m, IsWindowGroup o) => o -> m WindowGroup Source #

Cast to WindowGroup, for types for which this is known to be safe. For general casts, use castTo.

Methods

addWindow

windowGroupAddWindow Source #

Arguments

:: (HasCallStack, MonadIO m, IsWindowGroup a, IsWindow b) 
=> a

windowGroup: a GtkWindowGroup

-> b

window: the GtkWindow to add

-> m () 

Adds a window to a GtkWindowGroup.

listWindows

windowGroupListWindows Source #

Arguments

:: (HasCallStack, MonadIO m, IsWindowGroup a) 
=> a

windowGroup: a GtkWindowGroup

-> m [Window]

Returns: A newly-allocated list of windows inside the group.

Returns a list of the GtkWindows that belong to windowGroup.

new

windowGroupNew Source #

Arguments

:: (HasCallStack, MonadIO m) 
=> m WindowGroup

Returns: a new GtkWindowGroup.

Creates a new GtkWindowGroup object.

Modality of windows only affects windows within the same GtkWindowGroup.

removeWindow

windowGroupRemoveWindow Source #

Arguments

:: (HasCallStack, MonadIO m, IsWindowGroup a, IsWindow b) 
=> a

windowGroup: a GtkWindowGroup

-> b

window: the GtkWindow to remove

-> m () 

Removes a window from a GtkWindowGroup.