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

actor: Deprecate show_all()/hide_all()

Browse Source 
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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
clutter/clutter-actor.c
View File

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

8
clutter/clutter-actor.h
View File

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

6
clutter/deprecated/clutter-actor.h
View File

@ -77,6 +77,12 @@ void clutter_actor_push_internal (ClutterActor *self);
CLUTTER_DEPRECATED CLUTTER_DEPRECATED
void clutter_actor_pop_internal (ClutterActor *self); 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 G_END_DECLS
#endif /* __CLUTTER_ACTOR_DEPRECATED_H__ */ #endif /* __CLUTTER_ACTOR_DEPRECATED_H__ */