2007-10-10 Emmanuele Bassi <ebassi@openedhand.com>

* clutter/clutter-actor.c: Beautify the ClutterActor documentation.
This commit is contained in:
Emmanuele Bassi 2007-10-10 14:51:25 +00:00
parent 717a82303a
commit 261bc4c4f5
2 changed files with 23 additions and 9 deletions

View File

@ -1,3 +1,7 @@
2007-10-10 Emmanuele Bassi <ebassi@openedhand.com>
* clutter/clutter-actor.c: Beautify the ClutterActor documentation.
2007-10-10 Emmanuele Bassi <ebassi@openedhand.com> 2007-10-10 Emmanuele Bassi <ebassi@openedhand.com>
* clutter/clutter-actor.c: Remove the ::event-after signal: * clutter/clutter-actor.c: Remove the ::event-after signal:

View File

@ -34,14 +34,22 @@
* *
* Ordering of tranformations. FIXME. * Ordering of tranformations. FIXME.
* *
* Notes on clutter actor events: FIXME. * Notes on clutter actor events:
* * <orderedlist>
* - Actors emit pointer events if set reactive (#clutter_actor_set_reactive) * <listitem><para>Actors emit pointer events if set reactive, see
* - Keyboard events are emitted if actor has focus (#clutter_stage_set_focus) * clutter_actor_set_reactive()</para></listitem>
* - Motion events (motion, enter, leave) are only emitted per actor if * <listitem><para>Event handlers must return %TRUE if they handled
* #clutter_enable_motion_events called with TRUE. If set to FALSE (default) * the event and wish to block the event emission chain; and %FALSE
* then only the stage emits events. * if the emission chain must continue</para></listitem>
* - One emitted an event emission has two phases - capture and bubble. * <listitem><para>Keyboard events are emitted if actor has focus, see
* clutter_stage_set_focus()</para></listitem>
* <listitem><para>Motion events (motion, enter, leave) are only emitted
* per actor if clutter_enable_motion_events() was called with %TRUE. If
* set to %FALSE (the default) then only the stage emits motion
* events</para></listitem>
* <listitem><para>Once emitted, an event has two phases: capture
* and bubble</para></listitem>
* </orderedlist>
*/ */
#include "config.h" #include "config.h"
@ -2983,7 +2991,9 @@ clutter_actor_lower_bottom (ClutterActor *self)
* You should rarely need to use this function, except for * You should rarely need to use this function, except for
* synthetising events. * synthetising events.
* *
* Return value: the return value from the signal emission * Return value: the return value from the signal emission: %TRUE
* if the actor handled the event, or %FALSE if the event was
* not handled
* *
* Since: 0.6 * Since: 0.6
*/ */