Method

GdkWindowinvalidate_maybe_recurse

Declaration [src]

void
gdk_window_invalidate_maybe_recurse (
  GdkWindow* window,
  const cairo_region_t* region,
  GdkWindowChildFunc child_func,
  gpointer user_data
)

Description [src]

Adds region to the update area for window. The update area is the region that needs to be redrawn, or “dirty region.” The call gdk_window_process_updates() sends one or more expose events to the window, which together cover the entire update area. An application would normally redraw the contents of window in response to those expose events.

GDK will call gdk_window_process_all_updates() on your behalf whenever your program returns to the main loop and becomes idle, so normally there’s no need to do that manually, you just need to invalidate regions that you know should be redrawn.

The child_func parameter controls whether the region of each child window that intersects region will also be invalidated. Only children for which child_func returns TRUE will have the area invalidated.

Parameters

region

Type: cairo_region_t

A #cairo_region_t.

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

Type: GdkWindowChildFunc

Function to use to decide if to recurse to a child, NULL means never recurse.

The argument can be NULL.
user_data

Type: gpointer

Data passed to child_func.

The argument can be NULL.
The data is owned by the caller of the method.