brl/mutter
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: Mention signal-swapped-after modifier

Browse Source 
The signal-swapped-after:: modifier for signal connection inside the
clutter_actor_animate* variadic arguments functions is not mentioned in
the documentation.
This commit is contained in:
Emmanuele Bassi 2010-02-15 11:44:02 +00:00
parent 262782feae
commit 89191e8bbc
1 changed files with 24 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
clutter/clutter-animation.c
View File

@ -2042,11 +2042,10 @@ clutter_actor_animate_with_timeline (ClutterActor *actor,
* to control the animation or to know when the animation has been * to control the animation or to know when the animation has been
* completed. * completed.
* *
* If a name argument starts with "signal::", "signal-after::" or * If a name argument starts with "signal::", "signal-after::",
* "signal-swapped::" the two following arguments are used as callback * "signal-swapped::" or "signal-swapped-after::" the two following arguments
* function and data for a signal handler installed on the * are used as callback function and data for a signal handler installed on
* #ClutterAnimation object for the specified signal name, for * the #ClutterAnimation object for the specified signal name, for instance:
* instance:
* *
* |[ * |[
* *
@ -2063,13 +2062,28 @@ clutter_actor_animate_with_timeline (ClutterActor *actor,
* NULL); * NULL);
* ]| * ]|
* *
* or, to automatically destroy an actor at the end of the animation:
*
* |[
* clutter_actor_animate (actor, CLUTTER_EASE_IN_CUBIC, 100,
* "opacity", 0,
* "signal-swapped-after::completed",
* clutter_actor_destroy,
* actor,
* NULL);
* ]|
*
* The "signal::" modifier is the equivalent of using g_signal_connect(); * The "signal::" modifier is the equivalent of using g_signal_connect();
* the "signal-after::" modifier is the equivalent of using * the "signal-after::" modifier is the equivalent of using
* g_signal_connect_after(); the "signal-swapped::" modifier is the equivalent * g_signal_connect_after() or g_signal_connect_data() with the
* of using g_signal_connect_swapped(). The clutter_actor_animate() function * %G_CONNECT_AFTER; the "signal-swapped::" modifier is the equivalent
* will not keep track of multiple connections to the same signal, so it is * of using g_signal_connect_swapped() or g_signal_connect_data() with the
* your responsability to avoid them when calling clutter_actor_animate() * %G_CONNECT_SWAPPED flah; finally, the "signal-swapped-after::" modifier
* multiple times on the same actor. * is the equivalent of using g_signal_connect_data() with both the
* %G_CONNECT_AFTER and %G_CONNECT_SWAPPED flags. The clutter_actor_animate()
* function will not keep track of multiple connections to the same signal,
* so it is your responsability to avoid them when calling
* clutter_actor_animate() multiple times on the same actor.
* *
* Calling this function on an actor that is already being animated * Calling this function on an actor that is already being animated
* will cause the current animation to change with the new final values, * will cause the current animation to change with the new final values,