AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2024-11-14 12:41:07 +00:00
Code Issues Projects Releases Wiki Activity

Miscellaneous docs improvements

Browse Source 
Just the usual pre-release doc fixups.
This commit is contained in:
Matthias Clasen 2018-05-06 21:21:43 -04:00
parent 766185bce5
commit f5a2ab38f3
2 changed files with 13 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
gtk/gtksnapshot.c
View File

@ -44,11 +44,11 @@
* a cairo context, and maintains a stack of render nodes and their associated
* transformations.
*
* The node at the top of the stack is the the one that gtk_snapshot_append()
* operates on. Use the gtk_snapshot_push() and gtk_snapshot_pop() functions to
* change the current node.
* The node at the top of the stack is the the one that gtk_snapshot_append_…
* functions operate on. Use the gtk_snapshot_push_… functions and gtk_snapshot_pop()
* to change the current node.
*
* The typical way to obtain a #GtkSnapshot object is as an argument to
* The typical way to obtain a GtkSnapshot object is as an argument to
* the #GtkWidget::snapshot vfunc. If you need to create your own GtkSnapshot,
* use gtk_snapshot_new().
*/

19
gtk/gtkwidgetpaintable.c
View File

@ -31,26 +31,25 @@
* @Title: GtkWidgetPaintable
* @see_also: #GtkWidget, #GdkPaintable
*
* #GtkWidgetPaintable is an implementation of the #GdkPaintable interface
* GtkWidgetPaintable is an implementation of the #GdkPaintable interface
* that allows displaying the contents of a #GtkWidget.
*
* #GtkWidgetPaintable will also take care of the widget not being in a
* GtkWidgetPaintable will also take care of the widget not being in a
* state where it can be drawn (like when it isn't shown) and just draw
* nothing or where it does not have a size (like when it is hidden) and
* report no size in that case.
*
* Of course, #GtkWidgetPaintable allows you to monitor widgets for size
* changes by emitting the GdkPaintable::invalidate-size signal whenever
* Of course, GtkWidgetPaintable allows you to monitor widgets for size
* changes by emitting the #GdkPaintable::invalidate-size signal whenever
* the size of the widget changes as well as for visual changes by
* emitting the GdkPaintable::invalidate-contents signal whenever the
* emitting the #GdkPaintable::invalidate-contents signal whenever the
* widget changes.
*
* You can of course use a #GtkWidgetPaintable everywhere a
* You can of course use a GtkWidgetPaintable everywhere a
* #GdkPaintable is allowed, including using it on a #GtkImage (or one
* of its parents) that it was set on itself via
* gtk_image_set_from_paintable(). The paintable will take care of recursion
* when this happens.
* If you do this however, make sure to set the GtkImage:can-shrink property
* of its parents) that it was set on itself via gtk_image_set_from_paintable().
* The paintable will take care of recursion when this happens. If you do
* this however, make sure to set the #GtkImage:can-shrink property
* to %TRUE or you might end up with an infinitely growing image.
*/
struct _GtkWidgetPaintable