AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity

widgetpaintable: Convert docs

Browse Source
This commit is contained in:
Matthias Clasen 2021-03-01 01:47:47 -05:00 committed by Emmanuele Bassi
parent 4921497904
commit 3eeaef0834
1 changed files with 26 additions and 31 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

57
gtk/gtkwidgetpaintable.c
View File

@ -27,31 +27,28 @@
#include "gtkwidgetprivate.h" #include "gtkwidgetprivate.h"
/** /**
* SECTION:gtkwidgetpaintable * GtkWidgetPaintable:
* @Short_description: Drawing a widget elsewhere
* @Title: GtkWidgetPaintable
* @see_also: #GtkWidget, #GdkPaintable
* *
* GtkWidgetPaintable is an implementation of the #GdkPaintable interface * `GtkWidgetPaintable` is a `GdkPaintable` that displays the contents
* that allows displaying the contents of a #GtkWidget. * of a widget.
* *
* 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 * 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 * nothing or where it does not have a size (like when it is hidden) and
* report no size in that case. * report no size in that case.
* *
* Of course, GtkWidgetPaintable allows you to monitor widgets for size * Of course, `GtkWidgetPaintable` allows you to monitor widgets for size
* changes by emitting the #GdkPaintable::invalidate-size signal whenever * changes by emitting the [signal@Gdk.Paintable::invalidate-size] signal
* the size of the widget changes as well as for visual changes by * whenever the size of the widget changes as well as for visual changes by
* emitting the #GdkPaintable::invalidate-contents signal whenever the * emitting the [signal@Gdk.Paintable::invalidate-contents] signal whenever
* widget changes. * the widget changes.
* *
* You can of course use a GtkWidgetPaintable everywhere a * You can use a `GtkWidgetPaintable` everywhere a `GdkPaintable` is allowed,
* #GdkPaintable is allowed, including using it on a #GtkPicture (or one * including using it on a `GtkPicture` (or one of its parents) that it was
* of its parents) that it was set on itself via gtk_picture_set_paintable(). * set on itself via gtk_picture_set_paintable(). The paintable will take care
* The paintable will take care of recursion when this happens. If you do * of recursion when this happens. If you do this however, ensure that the
* this however, ensure the #GtkPicture:can-shrink property is set to * [property@Gtk.Picture:can-shrink] property is set to %TRUE or you might
* %TRUE or you might end up with an infinitely growing widget. * end up with an infinitely growing widget.
*/ */
struct _GtkWidgetPaintable struct _GtkWidgetPaintable
{ {
@ -241,7 +238,7 @@ gtk_widget_paintable_class_init (GtkWidgetPaintableClass *klass)
gobject_class->finalize = gtk_widget_paintable_finalize; gobject_class->finalize = gtk_widget_paintable_finalize;
/** /**
* GtkWidgetPaintable:widget * GtkWidgetPaintable:widget: (attributes org.gtk.Property.get=gtk_widget_paintable_get_widget org.gtk.Property.set=gtk_widget_paintable_set_widget)
* *
* The observed widget or %NULL if none. * The observed widget or %NULL if none.
*/ */
@ -263,12 +260,12 @@ gtk_widget_paintable_init (GtkWidgetPaintable *self)
/** /**
* gtk_widget_paintable_new: * gtk_widget_paintable_new:
* @widget: (allow-none) (transfer none): a #GtkWidget or %NULL * @widget: (allow-none) (transfer none): a `GtkWidget` or %NULL
* *
* Creates a new widget paintable observing the given widget. * Creates a new widget paintable observing the given widget.
* *
* Returns: (transfer full) (type GtkWidgetPaintable): a new #GtkWidgetPaintable * Returns: (transfer full) (type GtkWidgetPaintable): a new `GtkWidgetPaintable`
**/ */
GdkPaintable * GdkPaintable *
gtk_widget_paintable_new (GtkWidget *widget) gtk_widget_paintable_new (GtkWidget *widget)
{ {
@ -297,14 +294,13 @@ gtk_widget_paintable_snapshot_widget (GtkWidgetPaintable *self)
} }
/** /**
* gtk_widget_paintable_get_widget: * gtk_widget_paintable_get_widget: (attributes org.gtk.Method.get_property=widget)
* @self: a #GtkWidgetPaintable * @self: a `GtkWidgetPaintable`
* *
* Returns the widget that is observed or %NULL * Returns the widget that is observed or %NULL if none.
* if none.
* *
* Returns: (transfer none) (nullable): the observed widget. * Returns: (transfer none) (nullable): the observed widget.
**/ */
GtkWidget * GtkWidget *
gtk_widget_paintable_get_widget (GtkWidgetPaintable *self) gtk_widget_paintable_get_widget (GtkWidgetPaintable *self)
{ {
@ -314,12 +310,12 @@ gtk_widget_paintable_get_widget (GtkWidgetPaintable *self)
} }
/** /**
* gtk_widget_paintable_set_widget: * gtk_widget_paintable_set_widget: (attributes org.gtk.Method.set_property=widget)
* @self: a #GtkWidgetPaintable * @self: a `GtkWidgetPaintable`
* @widget: (allow-none): the widget to observe or %NULL * @widget: (allow-none): the widget to observe or %NULL
* *
* Sets the widget that should be observed. * Sets the widget that should be observed.
**/ */
void void
gtk_widget_paintable_set_widget (GtkWidgetPaintable *self, gtk_widget_paintable_set_widget (GtkWidgetPaintable *self,
GtkWidget *widget) GtkWidget *widget)
@ -408,4 +404,3 @@ gtk_widget_paintable_pop_snapshot_count (GtkWidgetPaintable *self)
{ {
self->snapshot_count--; self->snapshot_count--;
} }