widgetpaintable: Convert docs

This commit is contained in:
Matthias Clasen 2021-03-01 01:47:47 -05:00 committed by Emmanuele Bassi
parent 4921497904
commit 3eeaef0834

View File

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