callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages 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
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 * Note that calling cairo_reset_clip() on the resulting #cairo_t will
* produce undefined results, so avoid it at all costs. * 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 * Returns: A newly created Cairo context. Free with
* cairo_destroy() when you are done drawing. * cairo_destroy() when you are done drawing.
* *