mutter/doc/reference/tmpl/clutter-event.sgml
Emmanuele Bassi 10fbfb1659 2006-12-12 Emmanuele Bassi <ebassi@openedhand.com>
Rework part of the show/hide machinery.  Allow groups sub-classes
	and composite actors to override show_all/hide_all in order to
	decide which children they wish to show/hide.  This means that
	if an actor overrides the default show/hide virtual methods, it'll
	have to chain up to the parent class show/hide.  While we're at it,
	provide the fully recursive clutter_actor_show_all() and
	clutter_actor_hide_all() methods.

	* clutter/clutter-behaviour-path.c: Add apidoc for the ClutterKnot
	functions; add pathological equality case for clutter_knot_equal().

	* clutter/clutter-event.h:
	* clutter/clutter-feature.h:
	* clutter/clutter-behaviour.c:
	* clutter/clutter-behaviour-scale.c:Fix parameters name so that
	gtk-doc doesn't complain.

	* clutter/clutter-actor.c:
	* clutter/clutter-event.c: Add apidoc

	* clutter/clutter-actor.h:
	* clutter/clutter-actor.c: Add a clutter_actor_show_all() and a
	clutter_actor_hide_all() functions; provide a mechanism for
	groups and composited actors to programmatically select what to
	show/hide when clutter_actor_show_all() and clutter_actor_hide_all()
	are called.  If you are overriding the ClutterActor::show or
	the ClutterActor::hide virtual methods you should chain up with
	the parent class.

	* clutter/clutter-group.c: Override show_all and hide_all and
	recursively show/hide every child inside the group;
	clutter_group_show_all() and clutter_group_hide_all() remain as non
	recursive versions of clutter_actor_show_all() and
	clutter_actor_hide_all() (maybe we should rename them in order
	to avoid name clashes with the bindings).

	* clutter/clutter-stage.c:
	* clutter/clutter-texture.c: Chain up with parent class show
	and hide vfuncs.

	* clutter/clutter-clone-texture.h:
	* clutter/clutter-clone-texture.c: Provide API for changing the
	parent texture of a clone texture actor.

	* examples/behave.c:
	* examples/super-oh.c:
	* examples/test.c: Use clutter_actor_show_all() instead of
	clutter_group_show_all().
2006-12-12 20:20:04 +00:00

195 lines
2.2 KiB
Plaintext

<!-- ##### SECTION Title ##### -->
clutter-event
<!-- ##### SECTION Short_Description ##### -->
User and window system event functionality
<!-- ##### SECTION Long_Description ##### -->
<para>
Windowing events handled by Clutter.
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### ENUM ClutterEventType ##### -->
<para>
</para>
@CLUTTER_NOTHING:
@CLUTTER_KEY_PRESS:
@CLUTTER_KEY_RELEASE:
@CLUTTER_MOTION:
@CLUTTER_BUTTON_PRESS:
@CLUTTER_2BUTTON_PRESS:
@CLUTTER_BUTTON_RELEASE:
<!-- ##### MACRO CLUTTER_TYPE_EVENT ##### -->
<para>
</para>
<!-- ##### STRUCT ClutterAnyEvent ##### -->
<para>
</para>
@type:
<!-- ##### STRUCT ClutterKeyEvent ##### -->
<para>
</para>
@type:
@time:
@modifier_state:
@keyval:
@hardware_keycode:
<!-- ##### STRUCT ClutterButtonEvent ##### -->
<para>
</para>
@type:
@time:
@x:
@y:
@modifier_state:
@button:
@axes:
@device:
<!-- ##### STRUCT ClutterMotionEvent ##### -->
<para>
</para>
@type:
@time:
@x:
@y:
@modifier_state:
@axes:
@device:
<!-- ##### STRUCT ClutterInputDevice ##### -->
<para>
</para>
<!-- ##### UNION ClutterEvent ##### -->
<para>
</para>
<!-- ##### FUNCTION clutter_event_new ##### -->
<para>
</para>
@type:
@Returns:
<!-- ##### FUNCTION clutter_event_copy ##### -->
<para>
</para>
@event:
@Returns:
<!-- ##### FUNCTION clutter_event_free ##### -->
<para>
</para>
@event:
<!-- ##### FUNCTION clutter_key_event_time ##### -->
<para>
</para>
@keyev:
@Returns:
<!-- ##### FUNCTION clutter_key_event_state ##### -->
<para>
</para>
@keyev:
@Returns:
<!-- ##### FUNCTION clutter_button_event_x ##### -->
<para>
</para>
@buttev:
@Returns:
<!-- ##### FUNCTION clutter_button_event_y ##### -->
<para>
</para>
@buttev:
@Returns:
<!-- ##### FUNCTION clutter_key_event_symbol ##### -->
<para>
</para>
@keyev:
@Returns:
<!-- ##### FUNCTION clutter_key_event_code ##### -->
<para>
</para>
@keyev:
@Returns:
<!-- ##### FUNCTION clutter_key_event_unicode ##### -->
<para>
</para>
@keyev:
@Returns:
<!-- ##### FUNCTION clutter_keysym_to_unicode ##### -->
<para>
</para>
@keyval:
@Returns: