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.