## GtkWindowGroup GtkWindowGroup — Limit the effect of grabs |

## Synopsis

    #include <gtk/gtk.h>

                        GtkWindowGroup;
    GtkWindowGroup *    gtk_window_group_new                (void);
    void                gtk_window_group_add_window         (GtkWindowGroup *window_group,
                                                             GtkWindow *window);
    void                gtk_window_group_remove_window      (GtkWindowGroup *window_group,
                                                             GtkWindow *window);
    GList *             gtk_window_group_list_windows       (GtkWindowGroup *window_group);
    GtkWidget *         gtk_window_group_get_current_grab   (GtkWindowGroup *window_group);

## Object Hierarchy

      GObject
       +----GtkWindowGroup

## Description

## Details

### GtkWindowGroup

    typedef struct _GtkWindowGroup GtkWindowGroup;

### gtk_window_group_new ()

    GtkWindowGroup *    gtk_window_group_new                (void);

Creates a new GtkWindowGroup object. Grabs added with `gtk_grab_add()` only affect windows within the same GtkWindowGroup.

Returns : | a new GtkWindowGroup.

### gtk_window_group_add_window ()

    void                gtk_window_group_add_window         (GtkWindowGroup *window_group,
                                                             GtkWindow *window);

Adds a window to a GtkWindowGroup.

`window_group` : | a GtkWindowGroup
`window` : | the GtkWindow to add

### gtk_window_group_remove_window ()

    void                gtk_window_group_remove_window      (GtkWindowGroup *window_group,
                                                             GtkWindow *window);

Removes a window from a GtkWindowGroup.

`window_group` : | a GtkWindowGroup
`window` : | the GtkWindow to remove

### gtk_window_group_list_windows ()

    GList *             gtk_window_group_list_windows       (GtkWindowGroup *window_group);

Returns a list of the GtkWindows that belong to `window_group`.

`window_group` : | a GtkWindowGroup
Returns : | A newly-allocated list of windows inside the group. [element-type GtkWidget][transfer container GtkWidget]

Since 2.14

### gtk_window_group_get_current_grab ()

    GtkWidget *         gtk_window_group_get_current_grab   (GtkWindowGroup *window_group);

`window_group` : |
Returns : |