Method

GdkWindowinvalidate_region

Declaration [src]

void
gdk_window_invalidate_region (
  GdkWindow* window,
  const cairo_region_t* region,
  gboolean invalidate_children
)

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 invalidate_children parameter controls whether the region of each child window that intersects region will also be invalidated. If FALSE, then the update area for child windows will remain unaffected. See gdk_window_invalidate_maybe_recurse if you need fine grained control over which children are invalidated.

Parameters

region

Type: cairo_region_t

A #cairo_region_t.

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

Type: gboolean

TRUE to also invalidate child windows.