AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2024-11-16 21:50:34 +00:00
Code Issues Projects Releases Wiki Activity

gdkwindow: Add some extra documentation to gdk_cairo_create

Browse Source 
Mention the need to wrap the function inside
gdk_window_begin_paint_region and gdk_window_end_paint.
This commit is contained in:
Jasper St. Pierre 2014-06-21 09:58:20 -04:00
parent 93b3179042
commit ec5e913a9b
1 changed files with 5 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
gdk/gdkwindow.c
View File

@ -3030,6 +3030,11 @@ _gdk_window_ref_cairo_surface (GdkWindow *window)
* Note that calling cairo_reset_clip() on the resulting #cairo_t will
* produce undefined results, so avoid it at all costs.
*
* As of GTK+ 3.14, you need to wrap calls to this function with
* gdk_window_begin_paint_region() / gdk_window_begin_paint_rect() and
* gdk_window_end_paint(). Calling it outside of a "paint" will
* result in a warning printed and a dummy surface being returned.
*
* Returns: A newly created Cairo context. Free with
* cairo_destroy() when you are done drawing.
*