WidgetPaintable

class WidgetPaintable(**properties: Any)

Superclasses: Object

Implemented Interfaces: Paintable

GtkWidgetPaintable is a GdkPaintable that displays the contents of a widget.

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 invalidate_size signal whenever the size of the widget changes as well as for visual changes by emitting the invalidate_contents signal whenever the widget changes.

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 set_paintable(). The paintable will take care of recursion when this happens. If you do this however, ensure that the can_shrink property is set to True or you might end up with an infinitely growing widget.

Constructors

class WidgetPaintable
classmethod new(widget: Widget | None = None) WidgetPaintable

Creates a new widget paintable observing the given widget.

Parameters:

widget – a GtkWidget

Methods

class WidgetPaintable
get_widget() Widget | None

Returns the widget that is observed or None if none.

set_widget(widget: Widget | None = None) None

Sets the widget that should be observed.

Parameters:

widget – the widget to observe

Properties

class WidgetPaintable
props.widget: Widget

The observed widget or None if none.