This completes the documentation of the clutter.Actor signals.
Cheers, Daniel
Index: reference/clutter-clutteractor.xml =================================================================== --- reference/clutter-clutteractor.xml (revision 2069) +++ reference/clutter-clutteractor.xml (working copy) @@ -18,10 +18,6 @@ <classsynopsis language="python"> <ooclass><classname>clutter.Actor</classname></ooclass> <ooclass><classname>gobject.GInitiallyUnowned</classname></ooclass> - <constructorsynopsis language="python"> - <methodname><link linkend="constructor-clutteractor">clutter.Actor</link></methodname> - <methodparam></methodparam> - </constructorsynopsis> <methodsynopsis language="python"> <methodname><link linkend="method-clutteractor--show">show</link></methodname> @@ -195,16 +191,226 @@ <title>Signal Prototypes</title> <variablelist> + <varlistentry> - <term><link linkend="signal-clutteractor--destroy">"destroy"</link></term> + <term> + "<link linkend="signal-clutteractor--button-press-event">button-press-event</link>" + </term> <listitem> <methodsynopsis language="python"><methodname>callback</methodname> <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>event</parameter></methodparam> <methodparam><parameter>user_param1</parameter></methodparam> <methodparam><parameter>...</parameter></methodparam> </methodsynopsis> </listitem> </varlistentry> + + <varlistentry> + <term> + "<link linkend="signal-clutteractor--button-release-event">button-release-event</link>" + </term> + <listitem> + <methodsynopsis language="python"><methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>event</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis> + </listitem> + </varlistentry> + + <varlistentry> + <term> + "<link linkend="signal-clutteractor--captured-event">captured-event</link>" + </term> + <listitem> + <methodsynopsis language="python"><methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>event</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis> + </listitem> + </varlistentry> + + <varlistentry> + <term> + "<link linkend="signal-clutteractor--destroy">destroy</link>" + </term> + <listitem> + <methodsynopsis language="python"><methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis> + </listitem> + </varlistentry> + + <varlistentry> + <term> + "<link linkend="signal-clutteractor--enter-event">enter-event</link>" + </term> + <listitem> + <methodsynopsis language="python"><methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>event</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis> + </listitem> + </varlistentry> + + <varlistentry> + <term> + "<link linkend="signal-clutteractor--event">event</link>" + </term> + <listitem> + <methodsynopsis language="python"><methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>event</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis> + </listitem> + </varlistentry> + + <varlistentry> + <term> + "<link linkend="signal-clutteractor--focus-in">focus-in</link>" + </term> + <listitem> + <methodsynopsis language="python"><methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis> + </listitem> + </varlistentry> + + <varlistentry> + <term> + "<link linkend="signal-clutteractor--focus-out">focus-out</link>" + </term> + <listitem> + <methodsynopsis language="python"><methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis> + </listitem> + </varlistentry> + + <varlistentry> + <term> + "<link linkend="signal-clutteractor--hide">hide</link>" + </term> + <listitem> + <methodsynopsis language="python"><methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis> + </listitem> + </varlistentry> + + <varlistentry> + <term> + "<link linkend="signal-clutteractor--key-press-event">key-press-event</link>" + </term> + <listitem> + <methodsynopsis language="python"><methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>event</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis> + </listitem> + </varlistentry> + + <varlistentry> + <term> + "<link linkend="signal-clutteractor--key-release-event">key-release-event</link>" + </term> + <listitem> + <methodsynopsis language="python"><methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>event</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis> + </listitem> + </varlistentry> + + <varlistentry> + <term> + "<link linkend="signal-clutteractor--leave-event">leave-event</link>" + </term> + <listitem> + <methodsynopsis language="python"><methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>event</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis> + </listitem> + </varlistentry> + + <varlistentry> + <term> + "<link linkend="signal-clutteractor--motion-event">motion-event</link>" + </term> + <listitem> + <methodsynopsis language="python"><methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>event</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis> + </listitem> + </varlistentry> + + <varlistentry> + <term> + "<link linkend="signal-clutteractor--parent-set">parent-set</link>" + </term> + <listitem> + <methodsynopsis language="python"><methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>old_parent</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis> + </listitem> + </varlistentry> + + <varlistentry> + <term> + "<link linkend="signal-clutteractor--scroll-event">scroll-event</link>" + </term> + <listitem> + <methodsynopsis language="python"><methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>event</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis> + </listitem> + </varlistentry> + + <varlistentry> + <term> + "<link linkend="signal-clutteractor--show">show</link>" + </term> + <listitem> + <methodsynopsis language="python"><methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis> + </listitem> + </varlistentry> + </variablelist> </refsect1> @@ -224,30 +430,7 @@ <link linkend="class-clutteractor"><classname>clutter.Actor</classname></link> subclass.</para> </refsect1> -<!-- **************************** --> -<!-- BEGIN OF CLUTTER CONSTRUCTOR --> -<!-- **************************** --> - <refsect1 id="constructor-clutteractor"> - <title>Constructor</title> - - <programlisting><constructorsynopsis language="python"> - <methodname>clutter.Actor</methodname> - <methodparam></methodparam> - </constructorsynopsis></programlisting> - <variablelist> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>a new <link linkend="class-clutteractor"><classname>clutter.Actor</classname></link>. - </simpara></listitem> - </varlistentry> - </variablelist> - - <para> - Creates a new <link linkend="class-clutteractor"><classname>clutter.Actor</classname></link>.</para> - - </refsect1> - <!-- ****************************** --> <!-- BEGIN OF CLUTTER METHODS --> <!-- ****************************** --> @@ -280,8 +463,170 @@ <refsect1> <title>Signals</title> + <refsect2 id="signal-clutteractor--button-press-event"> + <title>The "button-press-event" clutter.Actor signal</title> + + <programlisting><methodsynopsis language="python"> + <methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>event</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis></programlisting> + + <variablelist> + <varlistentry> + <term> + <parameter>actor</parameter> : + </term> + <listitem> + <simpara>the object which received the event</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>event</parameter> : + </term> + <listitem> + <simpara>a <link linkend="class-clutterbuttonevent"><classname>clutter.ButtonEvent</classname></link></simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <parameter>user_param1</parameter> : + </term> + <listitem> + <simpara>the first user parameter (if any) specified + with the <methodname>connect</methodname>() method</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>...</parameter> : + </term> + <listitem> + <simpara>additional user parameters (if any)</simpara> + </listitem> + </varlistentry> + </variablelist> + + <para>The "button-press-event" signal is emitted each time a mouse button is pressed on <parameter>actor</parameter>.</para> + + </refsect2> + + <refsect2 id="signal-clutteractor--button-release-event"> + <title>The "button-release-event" clutter.Actor signal</title> + + <programlisting><methodsynopsis language="python"> + <methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>event</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis></programlisting> + + <variablelist> + <varlistentry> + <term> + <parameter>actor</parameter> : + </term> + <listitem> + <simpara>the object which received the event</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>event</parameter> : + </term> + <listitem> + <simpara>a <link linkend="class-clutterbuttonevent"><classname>clutter.ButtonEvent</classname></link></simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <parameter>user_param1</parameter> : + </term> + <listitem> + <simpara>the first user parameter (if any) specified + with the <methodname>connect</methodname>() method</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>...</parameter> : + </term> + <listitem> + <simpara>additional user parameters (if any)</simpara> + </listitem> + </varlistentry> + </variablelist> + + <para>The "button-release-event" signal is emitted each time a mouse button is released on <parameter>actor</parameter>.</para> + + </refsect2> + + <refsect2 id="signal-clutteractor--captured-event"> + <title>The "captured-event" clutter.Actor signal</title> + + <programlisting><methodsynopsis language="python"> + <methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>event</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis></programlisting> + + <variablelist> + <varlistentry> + <term> + <parameter>actor</parameter> : + </term> + <listitem> + <simpara>the object which received the signal</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>event</parameter> : + </term> + <listitem> + <simpara>a <link linkend="class-clutterevent"><classname>clutter.Event</classname></link></simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <parameter>user_param1</parameter> : + </term> + <listitem> + <simpara>the first user parameter (if any) specified + with the <methodname>connect</methodname>() method</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>...</parameter> : + </term> + <listitem> + <simpara>additional user parameters (if any)</simpara> + </listitem> + </varlistentry> + </variablelist> + + <para>The "captured-event" signal is emitted when an event is captured by Clutter. + This signal will be emitted starting from the top-level container (the + <link linkend="class-clutterstage"><classname>clutter.Stage</classname></link>) + to the actor which received the event going down the hierarchy. This signal + can be used to intercept every event before the specialized events + (like "<link linkend="signal-clutteractor--button-press-event">button-press-event</link>" or + "<link linkend="signal-clutteractor--button-released-event">key-released-event</link>") + are emitted.</para> + + </refsect2> <refsect2 id="signal-clutteractor--destroy"> - <title>The "destroy" signal</title> + <title>The "destroy" clutter.Actor signal</title> <programlisting><methodsynopsis language="python"> <methodname>callback</methodname> @@ -292,20 +637,29 @@ <variablelist> <varlistentry> - <term><parameter>actor</parameter> :</term> - <listitem><simpara>the object which received the signal</simpara></listitem> + <term> + <parameter>actor</parameter> : + </term> + <listitem> + <simpara>the object which received the signal</simpara> + </listitem> </varlistentry> <varlistentry> - <term><parameter>user_param1</parameter> :</term> - <listitem><simpara>the first user parameter (if any) specified - with the <link - linkend="method-gobject--connect"><methodname>connect</methodname>()</link> - method</simpara></listitem> + <term> + <parameter>user_param1</parameter> : + </term> + <listitem> + <simpara>the first user parameter (if any) specified + with the <methodname>connect</methodname>() method</simpara> + </listitem> </varlistentry> <varlistentry> - <term><parameter>...</parameter> :</term> - <listitem><simpara>additional user parameters (if - any)</simpara></listitem> + <term> + <parameter>...</parameter> : + </term> + <listitem> + <simpara>additional user parameters (if any)</simpara> + </listitem> </varlistentry> </variablelist> @@ -315,6 +669,666 @@ contains the actor is destroyed.</para> </refsect2> + + <refsect2 id="signal-clutteractor--enter-event"> + <title>The "enter-event" clutter.Actor signal</title> + + <programlisting><methodsynopsis language="python"> + <methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>event</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis></programlisting> + + <variablelist> + <varlistentry> + <term> + <parameter>actor</parameter> : + </term> + <listitem> + <simpara>the object which the pointer has entered</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>event</parameter> : + </term> + <listitem> + <simpara>a <link linkend="class-cluttercrossingevent"><classname>clutter.CrossingEvent</classname></link></simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <parameter>user_param1</parameter> : + </term> + <listitem> + <simpara>the first user parameter (if any) specified + with the <methodname>connect</methodname>() method</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>...</parameter> : + </term> + <listitem> + <simpara>additional user parameters (if any)</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>Returns</parameter> : + </term> + <listitem> + <simpara><code>True</code> if the event has been handled by the actor, + or <code>False</code> to continue the emission.</simpara> + </listitem> + </varlistentry> + + </variablelist> + + <para>The "event-event" signal is emitted when the pointer enters the <parameter>actor</parameter>.</para> + + </refsect2> + + <refsect2 id="signal-clutteractor--event"> + <title>The "event" clutter.Actor signal</title> + + <programlisting><methodsynopsis language="python"> + <methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>event</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis></programlisting> + + <variablelist> + <varlistentry> + <term> + <parameter>actor</parameter> : + </term> + <listitem> + <simpara>the object which received the event</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>event</parameter> : + </term> + <listitem> + <simpara>a <link linkend="class-cluttercrossingevent"><classname>clutter.Event</classname></link></simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <parameter>user_param1</parameter> : + </term> + <listitem> + <simpara>the first user parameter (if any) specified + with the <methodname>connect</methodname>() method</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>...</parameter> : + </term> + <listitem> + <simpara>additional user parameters (if any)</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>Returns</parameter> : + </term> + <listitem> + <simpara><code>True</code> if the event has been handled by the actor, + or <code>False</code> to continue the emission.</simpara> + </listitem> + </varlistentry> + + </variablelist> + + <para>The "event" signal is emitted each time an event is received by the actor. + This signal will be emitted on every actor, following the hierarchy chain, + until it reaches the top-level container (the + <link linkend="class-clutterstage"><classname>clutter.Stage</classname></link>).</para> + + </refsect2> + + <refsect2 id="signal-clutteractor--focus-in"> + <title>The "focus-in" clutter.Actor signal</title> + + <programlisting><methodsynopsis language="python"> + <methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis></programlisting> + + <variablelist> + <varlistentry> + <term> + <parameter>actor</parameter> : + </term> + <listitem> + <simpara>the actor which now now has key focus</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>user_param1</parameter> : + </term> + <listitem> + <simpara>the first user parameter (if any) specified + with the <methodname>connect</methodname>() method</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>...</parameter> : + </term> + <listitem> + <simpara>additional user parameters (if any)</simpara> + </listitem> + </varlistentry> + </variablelist> + + <para>The "focus-in" signal is emitted when <parameter>actor</parameter> recieves key focus.</para> + + </refsect2> + + <refsect2 id="signal-clutteractor--focus-out"> + <title>The "focus-out" clutter.Actor signal</title> + + <programlisting><methodsynopsis language="python"> + <methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis></programlisting> + + <variablelist> + <varlistentry> + <term> + <parameter>actor</parameter> : + </term> + <listitem> + <simpara>the actor which now now has key focus</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>user_param1</parameter> : + </term> + <listitem> + <simpara>the first user parameter (if any) specified + with the <methodname>connect</methodname>() method</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>...</parameter> : + </term> + <listitem> + <simpara>additional user parameters (if any)</simpara> + </listitem> + </varlistentry> + </variablelist> + + <para>The "focus-out" signal is emitted when <parameter>actor</parameter> loses key focus.</para> + + </refsect2> + + <refsect2 id="signal-clutteractor--hide"> + <title>The "hide" clutter.Actor signal</title> + + <programlisting><methodsynopsis language="python"> + <methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis></programlisting> + + <variablelist> + <varlistentry> + <term> + <parameter>actor</parameter> : + </term> + <listitem> + <simpara>the object which received the signal</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>user_param1</parameter> : + </term> + <listitem> + <simpara>the first user parameter (if any) specified + with the <methodname>connect</methodname>() method</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>...</parameter> : + </term> + <listitem> + <simpara>additional user parameters (if any)</simpara> + </listitem> + </varlistentry> + </variablelist> + + <para>The "hide" signal is emitted when an actor is no longer visible.</para> + + </refsect2> + + <refsect2 id="signal-clutteractor--key-press-event"> + <title>The "key-press-event" clutter.Actor signal</title> + + <programlisting><methodsynopsis language="python"> + <methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>event</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis></programlisting> + + <variablelist> + <varlistentry> + <term> + <parameter>actor</parameter> : + </term> + <listitem> + <simpara>the actor which received the event</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>event</parameter> : + </term> + <listitem> + <simpara>a <link linkend="class-clutterkeyevent"><classname>clutter.KeyEvent</classname></link></simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <parameter>user_param1</parameter> : + </term> + <listitem> + <simpara>the first user parameter (if any) specified + with the <methodname>connect</methodname>() method</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>...</parameter> : + </term> + <listitem> + <simpara>additional user parameters (if any)</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>Returns</parameter> : + </term> + <listitem> + <simpara><code>True</code> if the event has been handled by the actor, + or <code>False</code> to continue the emission.</simpara> + </listitem> + </varlistentry> + + </variablelist> + + <para>The "key-press-event" signal is emitted each time a keyboard button + is pressed on <parameter>actor</parameter>.</para> + + </refsect2> + + <refsect2 id="signal-clutteractor--key-release-event"> + <title>The "key-release-event" clutter.Actor signal</title> + + <programlisting><methodsynopsis language="python"> + <methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>event</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis></programlisting> + + <variablelist> + <varlistentry> + <term> + <parameter>actor</parameter> : + </term> + <listitem> + <simpara>the actor which received the event</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>event</parameter> : + </term> + <listitem> + <simpara>a <link linkend="class-clutterkeyevent"><classname>clutter.KeyEvent</classname></link></simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <parameter>user_param1</parameter> : + </term> + <listitem> + <simpara>the first user parameter (if any) specified + with the <methodname>connect</methodname>() method</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>...</parameter> : + </term> + <listitem> + <simpara>additional user parameters (if any)</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>Returns</parameter> : + </term> + <listitem> + <simpara><code>True</code> if the event has been handled by the actor, + or <code>False</code> to continue the emission.</simpara> + </listitem> + </varlistentry> + + </variablelist> + + <para>The "key-press-event" signal is emitted each time a keyboard button + is released on <parameter>actor</parameter>.</para> + + </refsect2> + + <refsect2 id="signal-clutteractor--leave-event"> + <title>The "leave-event" clutter.Actor signal</title> + + <programlisting><methodsynopsis language="python"> + <methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>event</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis></programlisting> + + <variablelist> + <varlistentry> + <term> + <parameter>actor</parameter> : + </term> + <listitem> + <simpara>the actor which the pointer has left</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>event</parameter> : + </term> + <listitem> + <simpara>a <link linkend="class-cluttercrossingevent"><classname>clutter.CrossingEvent</classname></link></simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <parameter>user_param1</parameter> : + </term> + <listitem> + <simpara>the first user parameter (if any) specified + with the <methodname>connect</methodname>() method</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>...</parameter> : + </term> + <listitem> + <simpara>additional user parameters (if any)</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>Returns</parameter> : + </term> + <listitem> + <simpara><code>True</code> if the event has been handled by the actor, + or <code>False</code> to continue the emission.</simpara> + </listitem> + </varlistentry> + + </variablelist> + + <para>The "leave-event" signal is emitted when the pointer leaves the <parameter>actor</parameter>.</para> + + </refsect2> + + <refsect2 id="signal-clutteractor--motion-event"> + <title>The "motion-event" clutter.Actor signal</title> + + <programlisting><methodsynopsis language="python"> + <methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>event</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis></programlisting> + + <variablelist> + <varlistentry> + <term> + <parameter>actor</parameter> : + </term> + <listitem> + <simpara>the actor which the pointer has moved on</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>event</parameter> : + </term> + <listitem> + <simpara>a <link linkend="class-cluttermotionevent"><classname>clutter.MotionEvent</classname></link></simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <parameter>user_param1</parameter> : + </term> + <listitem> + <simpara>the first user parameter (if any) specified + with the <methodname>connect</methodname>() method</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>...</parameter> : + </term> + <listitem> + <simpara>additional user parameters (if any)</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>Returns</parameter> : + </term> + <listitem> + <simpara><code>True</code> if the event has been handled by the actor, + or <code>False</code> to continue the emission.</simpara> + </listitem> + </varlistentry> + + </variablelist> + + <para>The "motion-event" signal is emitted each time the mouse pointer is moved on <parameter>actor</parameter>.</para> + + </refsect2> + + <refsect2 id="signal-clutteractor--parent-set"> + <title>The "parent-set" clutter.Actor signal</title> + + <programlisting><methodsynopsis language="python"> + <methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>old_parent</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis></programlisting> + + <variablelist> + <varlistentry> + <term> + <parameter>actor</parameter> : + </term> + <listitem> + <simpara>the actor which received the signal</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>old_parent</parameter> : + </term> + <listitem> + <simpara>the previous parent of the actor, or <code>None</code></simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <parameter>user_param1</parameter> : + </term> + <listitem> + <simpara>the first user parameter (if any) specified + with the <methodname>connect</methodname>() method</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>...</parameter> : + </term> + <listitem> + <simpara>additional user parameters (if any)</simpara> + </listitem> + </varlistentry> + </variablelist> + + <para>The "parent-set" signal is emitted when the parent of the actor changes.</para> + + </refsect2> + + <refsect2 id="signal-clutteractor--scroll-event"> + <title>The "scroll-event" clutter.Actor signal</title> + + <programlisting><methodsynopsis language="python"> + <methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>event</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis></programlisting> + + <variablelist> + <varlistentry> + <term> + <parameter>actor</parameter> : + </term> + <listitem> + <simpara>the actor which received the event</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>event</parameter> : + </term> + <listitem> + <simpara>a <link linkend="class-clutterscrollevent"><classname>clutter.ScrollEvent</classname></link></simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term> + <parameter>user_param1</parameter> : + </term> + <listitem> + <simpara>the first user parameter (if any) specified + with the <methodname>connect</methodname>() method</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>...</parameter> : + </term> + <listitem> + <simpara>additional user parameters (if any)</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>Returns</parameter> : + </term> + <listitem> + <simpara><code>True</code> if the event has been handled by the actor, + or <code>False</code> to continue the emission.</simpara> + </listitem> + </varlistentry> + + </variablelist> + + <para>The "scroll-event" signal is emitted each time the mouse is scrolled on <parameter>actor</parameter>.</para> + + </refsect2> + + <refsect2 id="signal-clutteractor--show"> + <title>The "show" clutter.Actor signal</title> + + <programlisting><methodsynopsis language="python"> + <methodname>callback</methodname> + <methodparam><parameter>actor</parameter></methodparam> + <methodparam><parameter>user_param1</parameter></methodparam> + <methodparam><parameter>...</parameter></methodparam> + </methodsynopsis></programlisting> + + <variablelist> + <varlistentry> + <term> + <parameter>actor</parameter> : + </term> + <listitem> + <simpara>the actor which received the event</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>user_param1</parameter> : + </term> + <listitem> + <simpara>the first user parameter (if any) specified + with the <methodname>connect</methodname>() method</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <parameter>...</parameter> : + </term> + <listitem> + <simpara>additional user parameters (if any)</simpara> + </listitem> + </varlistentry> + </variablelist> + + <para>The "show" signal is emitted when an actor becomes visible.</para> + + </refsect2> + </refsect1> </refentry>
signature.asc
Description: This is a digitally signed message part