Gtk.WidgetPaintable¶

Subclasses:: None

Methods¶

Inherited:: GObject.Object (37), Gdk.Paintable (10)
Structs:: GObject.ObjectClass (5)

class	`new` (widget)
	`get_widget` ()
	`set_widget` (widget)

Virtual Methods¶

Inherited:: GObject.Object (7), Gdk.Paintable (6)

Properties¶

Name	Type	Flags	Short Description
`widget`	`Gtk.Widget`	r/w/en

Signals¶

Inherited:: GObject.Object (1), Gdk.Paintable (2)

Fields¶

Inherited:: GObject.Object (1), Gdk.Paintable (2)

Class Details¶

class Gtk.WidgetPaintable(**kwargs)¶

Bases:: GObject.Object, Gdk.Paintable
Abstract:: No
Structure:: Gtk.WidgetPaintableClass

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 [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 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.

classmethod new(widget)[source]¶

Parameters:: widget (Gtk.Widget or None) – a GtkWidget
Returns:: a new GtkWidgetPaintable
Return type:: Gtk.WidgetPaintable

Creates a new widget paintable observing the given widget.

get_widget()[source]¶

Returns:: the observed widget.
Return type:: Gtk.Widget or None

Returns the widget that is observed or None if none.

set_widget(widget)[source]¶

Parameters:: widget (Gtk.Widget or None) – the widget to observe

Sets the widget that should be observed.

Property Details¶

Gtk.WidgetPaintable.props.widget¶

Name:: widget
Type:: Gtk.Widget
Default Value:: None
Flags:: READABLE, WRITABLE, EXPLICIT_NOTIFY

The observed widget or None if none.