Clutter.Content

Implementations:

Clutter.Canvas, Clutter.Image

Methods

	get_preferred_size ()
	invalidate ()

Virtual Methods

	do_attached (actor)
	do_detached (actor)
	do_get_preferred_size ()
	do_invalidate ()
	do_paint_content (actor, node)

Properties

None

Signals

Name	Short Description
attached	This signal is emitted each time a Clutter.Content implementation is assigned to a Clutter.Actor.
detached	This signal is emitted each time a Clutter.Content implementation is removed from a Clutter.Actor.

Fields

None

Class Details

class Clutter.Content

Bases:

GObject.GInterface

Structure:

Clutter.ContentIface

The Clutter.Content structure is an opaque type whose members cannot be acccessed directly.

New in version 1.10.

get_preferred_size()

Returns:

True if the content has a preferred size, and False otherwise

width:

return location for the natural width of the content

height:

return location for the natural height of the content

Return type:

(bool, width: float, height: float)

Retrieves the natural size of the self, if any.

The natural size of a Clutter.Content is defined as the size the content would have regardless of the allocation of the actor that is painting it, for instance the size of an image data.

New in version 1.10.

invalidate()

Invalidates a Clutter.Content.

This function should be called by Clutter.Content implementations when they change the way a the content should be painted regardless of the actor state.

New in version 1.10.

do_attached(actor) virtual

Parameters:

actor (Clutter.Actor) –

virtual function; called each time a Clutter.Content is attached to a Clutter.Actor.

do_detached(actor) virtual

Parameters:

actor (Clutter.Actor) –

virtual function; called each time a Clutter.Content is detached from a Clutter.Actor.

do_get_preferred_size() virtual

Returns:

True if the content has a preferred size, and False otherwise

width:

return location for the natural width of the content

height:

return location for the natural height of the content

Return type:

(bool, width: float, height: float)

Retrieves the natural size of the content, if any.

The natural size of a Clutter.Content is defined as the size the content would have regardless of the allocation of the actor that is painting it, for instance the size of an image data.

New in version 1.10.

do_invalidate() virtual

Invalidates a Clutter.Content.

This function should be called by Clutter.Content implementations when they change the way a the content should be painted regardless of the actor state.

New in version 1.10.

do_paint_content(actor, node) virtual

Parameters:

• actor (Clutter.Actor) –

• node (Clutter.PaintNode) –

virtual function; called each time the content needs to paint itself

Signal Details

Clutter.Content.signals.attached(content, actor)

Signal Name:

attached

Flags:

RUN_FIRST

Parameters:

• content (Clutter.Content) – The object which received the signal

• actor (Clutter.Actor) – a Clutter.Actor

This signal is emitted each time a Clutter.Content implementation is assigned to a Clutter.Actor.

New in version 1.10.

Clutter.Content.signals.detached(content, actor)

Signal Name:

detached

Flags:

RUN_FIRST

Parameters:

• content (Clutter.Content) – The object which received the signal

• actor (Clutter.Actor) – a Clutter.Actor

This signal is emitted each time a Clutter.Content implementation is removed from a Clutter.Actor.

New in version 1.10.