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

Soft-deprecation of actor state macros

Browse Source 
These are just terrible API that we've been stringing along since the
0.x days. We cannot truly deprecate them, because they are, in some
cases, the only actual API to perform some operation, and porting all
the code in the world is not going to make us any friends.

For the time being, we use a deprecation notice in the documentation.
This commit is contained in:
Emmanuele Bassi 2015-04-14 12:46:49 +01:00
parent 849607316a
commit 4c6a550d13
2 changed files with 20 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
clutter/clutter-actor.c
View File

@ -544,6 +544,9 @@
* unnecessary (and potentially expensive) state changes.
*
* Since: 0.2
*
* Deprecated: 1.24: Use clutter_actor_is_mapped() or the #ClutterActor:mapped
* property instead of this macro.
*/
/**
@ -566,6 +569,9 @@
* must be realized.
*
* Since: 0.2
*
* Deprecated: 1.24: Use clutter_actor_is_realized() or the #ClutterActor:realized
* property instead of this macro.
*/
/**
@ -580,6 +586,9 @@
* parents is a toplevel stage; see also %CLUTTER_ACTOR_IS_MAPPED.
*
* Since: 0.2
*
* Deprecated: 1.24: Use clutter_actor_is_visible() or the #ClutterActor:visible
* property instead of this macro.
*/
/**
@ -591,6 +600,9 @@
* Only reactive actors will receive event-related signals.
*
* Since: 0.6
*
* Deprecated: 1.24: Use clutter_actor_get_reactive() or the
* #ClutterActor:reactive property instead of this macro.
*/
#include "config.h"

8
clutter/clutter-actor.h
View File

@ -54,6 +54,10 @@ G_BEGIN_DECLS
* @f: the #ClutterActorFlags to set
*
* Sets the given flags on a #ClutterActor
*
* Deprecated: 1.24: Changing flags directly is heavily discouraged in
* newly written code. #ClutterActor will take care of setting the
* internal state.
*/
#define CLUTTER_ACTOR_SET_FLAGS(a,f) (((ClutterActor*)(a))->flags |= (f))
@ -63,6 +67,10 @@ G_BEGIN_DECLS
* @f: the #ClutterActorFlags to unset
*
* Unsets the given flags on a #ClutterActor
*
* Deprecated: 1.24: Changing flags directly is heavily discouraged in
* newly written code. #ClutterActor will take care of unsetting the
* internal state.
*/
#define CLUTTER_ACTOR_UNSET_FLAGS(a,f) (((ClutterActor*)(a))->flags &= ~(f))