Note that calling cairo.context.Context.resetClip on the resulting #cairo_t will
produce undefined results, so avoid it at all costs.
Typically, this function is used to draw on a #GdkWindow out of the paint
cycle of the toolkit; this should be avoided, as it breaks various assumptions
and optimizations.
Creates a Cairo context for drawing to window.
Note that calling cairo.context.Context.resetClip on the resulting #cairo_t will produce undefined results, so avoid it at all costs.
Typically, this function is used to draw on a #GdkWindow out of the paint cycle of the toolkit; this should be avoided, as it breaks various assumptions and optimizations.
If you are drawing on a native #GdkWindow in response to a gdk.types.EventType.Expose event you should use gdk.window.Window.beginDrawFrame and gdk.drawing_context.DrawingContext.getCairoContext instead. GTK will automatically do this for you when drawing a widget.