Gdk Extensions: libxfce4ui Reference Manual

## Gdk Extensions Gdk Extensions — various extensions to Gdk |

## Stability Level

Stable, unless otherwise indicated

## Functions

GdkScreen * | xfce_gdk_screen_get_active ()
GdkRectangle * | xfce_gdk_screen_get_geometry ()
gboolean | xfce_gdk_device_grab ()

## Includes

    #include <libxfce4ui/libxfce4ui.h>

## Description

Common used functions that are not provided by the Gdk or Gdk-pixbuf library.

## Functions

### xfce_gdk_screen_get_active ()

    GdkScreen *
    xfce_gdk_screen_get_active (gint *monitor_return);

Returns the currently active GdkScreen, that is, the screen which currently contains the pointer. If no active screen was found, the default GdkScreen is returned.

#### Parameters

monitor_return | Address to store the monitor number to or `NULL`. | [out][nullable]

#### Returns

the currently active GdkScreen.

[transfer none]

### xfce_gdk_screen_get_geometry ()

    GdkRectangle *
    xfce_gdk_screen_get_geometry (void);

Returns the width and height of the default GdkScreen. This is a replacement for gdk_screen_width/gdk_screen_height.

#### Returns

a newly created GdkRectangle containing the width and height of the screen.

[transfer full]

Since: 4.14

### xfce_gdk_device_grab ()

    gboolean
    xfce_gdk_device_grab (GdkSeat *seat,
                          GdkWindow *window,
                          GdkSeatCapabilities capabilities,
                          GdkCursor *cursor);

Similar to gdk_seat_grab but tries to grab the seat five times with 100ms between each attempt.

#### Parameters

seat | A GdkSeat. |
window | The GdkWindow which will own the grab. |
capabilities | Capabilities that will be grabbed. |
cursor | The cursor to display while the grab is active. If this is `NULL` then the normal cursors are used for window and its descendants, and the cursor for window is used elsewhere. | [nullable]

#### Returns

`TRUE` on success, `FALSE` otherwise.

Since: 4.18