Method

GdkWindowshape_combine_region

Declaration [src]

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

Description [src]

Makes pixels in window outside shape_region be transparent, so that the window may be nonrectangular.

If shape_region is NULL, the shape will be unset, so the whole window will be opaque again. offset_x and offset_y are ignored if shape_region is NULL.

On the X11 platform, this uses an X server extension which is widely available on most common platforms, but not available on very old X servers, and occasionally the implementation will be buggy. On servers without the shape extension, this function will do nothing.

This function works on both toplevel and child windows.

Parameters

shape_region

Type: cairo_region_t

Region of window to be non-transparent.

The argument can be NULL.
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.