Method

GdkWindowinput_shape_combine_region

since: 2.10

Declaration [src]

void
gdk_window_input_shape_combine_region (
  GdkWindow* window,
  const cairo_region_t* shape_region,
  gint offset_x,
  gint offset_y
)

Description [src]

Like gdk_window_shape_combine_region(), but the shape applies only to event handling. Mouse events which happen while the pointer position corresponds to an unset bit in the mask will be passed on the window below window.

An input shape is typically used with RGBA windows. The alpha channel of the window defines which pixels are invisible and allows for nicely antialiased borders, and the input shape controls where the window is “clickable”.

On the X11 platform, this requires version 1.1 of the shape extension.

On the Win32 platform, this functionality is not present and the function does nothing.

Available since: 2.10

Parameters

shape_region

Type: cairo_region_t

Region of window to be non-transparent.

The data is owned by the caller of the method.
offset_x

Type: gint

X position of shape_region in window coordinates.

offset_y

Type: gint

Y position of shape_region in window coordinates.