actor: Deprecate show_all()/hide_all()

The hide_all() method is pretty much pointless, as hiding an actor will
automatically prevent its children from being painted. The show_all()
method would only be marginally useful, if actors weren't set to be
visible by default when added to another actor - which was the case when
we introduced show_all() and hide_all().
This commit is contained in:
Emmanuele Bassi 2012-01-17 16:11:29 +00:00
parent d363279fd3
commit 0f39f20db6
3 changed files with 15 additions and 4 deletions

View File

@ -1311,6 +1311,8 @@ clutter_actor_show (ClutterActor *self)
* Calls clutter_actor_show() on all children of an actor (if any).
*
* Since: 0.2
*
* Deprecated: 1.10: Actors are visible by default
*/
void
clutter_actor_show_all (ClutterActor *self)
@ -1404,6 +1406,9 @@ clutter_actor_hide (ClutterActor *self)
* Calls clutter_actor_hide() on all child actors (if any).
*
* Since: 0.2
*
* Deprecated: 1.10: Using clutter_actor_hide() on the actor will
* prevent its children from being painted as well.
*/
void
clutter_actor_hide_all (ClutterActor *self)

View File

@ -119,13 +119,15 @@ struct _ClutterActor
* @show_all: virtual function for containers and composite actors, to
* determine which children should be shown when calling
* clutter_actor_show_all() on the actor. Defaults to calling
* clutter_actor_show().
* clutter_actor_show(). This virtual function is deprecated and it
* should not be overridden.
* @hide: signal class handler for #ClutterActor::hide; it must chain
* up to the parent's implementation
* @hide_all: virtual function for containers and composite actors, to
* determine which children should be shown when calling
* clutter_actor_hide_all() on the actor. Defaults to calling
* clutter_actor_hide().
* clutter_actor_hide(). This virtual function is deprecated and it
* should not be overridden.
* @realize: virtual function, used to allocate resources for the actor;
* it should chain up to the parent's implementation
* @unrealize: virtual function, used to deallocate resources allocated
@ -272,9 +274,7 @@ void clutter_actor_unset_flags (ClutterActor
ClutterActorFlags clutter_actor_get_flags (ClutterActor *self);
void clutter_actor_show (ClutterActor *self);
void clutter_actor_show_all (ClutterActor *self);
void clutter_actor_hide (ClutterActor *self);
void clutter_actor_hide_all (ClutterActor *self);
void clutter_actor_realize (ClutterActor *self);
void clutter_actor_unrealize (ClutterActor *self);
void clutter_actor_map (ClutterActor *self);

View File

@ -77,6 +77,12 @@ void clutter_actor_push_internal (ClutterActor *self);
CLUTTER_DEPRECATED
void clutter_actor_pop_internal (ClutterActor *self);
CLUTTER_DEPRECATED
void clutter_actor_show_all (ClutterActor *self);
CLUTTER_DEPRECATED
void clutter_actor_hide_all (ClutterActor *self);
G_END_DECLS
#endif /* __CLUTTER_ACTOR_DEPRECATED_H__ */