491 lines
16 KiB
C
491 lines
16 KiB
C
#include "evas_common.h"
|
|
#include "evas_private.h"
|
|
#include "Evas.h"
|
|
|
|
static void evas_object_event_callback_list_free(Evas_Object_List **list);
|
|
static void evas_object_event_callback_list_post_free(Evas_Object_List **list);
|
|
static void evas_object_event_callback_clear(Evas_Object *obj);
|
|
|
|
static void
|
|
evas_object_event_callback_list_free(Evas_Object_List **list)
|
|
{
|
|
/* MEM OK */
|
|
while (*list)
|
|
{
|
|
Evas_Func_Node *fn;
|
|
|
|
fn = (Evas_Func_Node *)(*list);
|
|
*list = evas_object_list_remove(*list, fn);
|
|
free(fn);
|
|
}
|
|
}
|
|
|
|
static void
|
|
evas_object_event_callback_list_post_free(Evas_Object_List **list)
|
|
{
|
|
Evas_Object_List *l;
|
|
|
|
/* MEM OK */
|
|
for (l = *list; l;)
|
|
{
|
|
Evas_Func_Node *fn;
|
|
|
|
fn = (Evas_Func_Node *)l;
|
|
l = l->next;
|
|
if (fn->delete_me)
|
|
{
|
|
*list = evas_object_list_remove(*list, fn);
|
|
free(fn);
|
|
}
|
|
}
|
|
}
|
|
|
|
static void
|
|
evas_object_event_callback_clear(Evas_Object *obj)
|
|
{
|
|
Evas_Callback_Type t;
|
|
|
|
if (!obj->callbacks.deletions_waiting) return;
|
|
obj->callbacks.deletions_waiting = 0;
|
|
evas_object_event_callback_list_post_free(&(obj->callbacks.in));
|
|
evas_object_event_callback_list_post_free(&(obj->callbacks.out));
|
|
evas_object_event_callback_list_post_free(&(obj->callbacks.down));
|
|
evas_object_event_callback_list_post_free(&(obj->callbacks.up));
|
|
evas_object_event_callback_list_post_free(&(obj->callbacks.move));
|
|
evas_object_event_callback_list_post_free(&(obj->callbacks.free));
|
|
evas_object_event_callback_list_post_free(&(obj->callbacks.key_down));
|
|
evas_object_event_callback_list_post_free(&(obj->callbacks.key_up));
|
|
evas_object_event_callback_list_post_free(&(obj->callbacks.obj_focus_in));
|
|
evas_object_event_callback_list_post_free(&(obj->callbacks.obj_focus_out));
|
|
evas_object_event_callback_list_post_free(&(obj->callbacks.obj_show));
|
|
evas_object_event_callback_list_post_free(&(obj->callbacks.obj_hide));
|
|
evas_object_event_callback_list_post_free(&(obj->callbacks.obj_move));
|
|
evas_object_event_callback_list_post_free(&(obj->callbacks.obj_resize));
|
|
evas_object_event_callback_list_post_free(&(obj->callbacks.obj_restack));
|
|
}
|
|
|
|
void
|
|
evas_object_event_callback_cleanup(Evas_Object *obj)
|
|
{
|
|
/* MEM OK */
|
|
evas_object_event_callback_list_free(&(obj->callbacks.in));
|
|
evas_object_event_callback_list_free(&(obj->callbacks.out));
|
|
evas_object_event_callback_list_free(&(obj->callbacks.down));
|
|
evas_object_event_callback_list_free(&(obj->callbacks.up));
|
|
evas_object_event_callback_list_free(&(obj->callbacks.move));
|
|
evas_object_event_callback_list_free(&(obj->callbacks.free));
|
|
evas_object_event_callback_list_free(&(obj->callbacks.key_down));
|
|
evas_object_event_callback_list_free(&(obj->callbacks.key_up));
|
|
evas_object_event_callback_list_free(&(obj->callbacks.obj_focus_in));
|
|
evas_object_event_callback_list_free(&(obj->callbacks.obj_focus_out));
|
|
evas_object_event_callback_list_free(&(obj->callbacks.obj_show));
|
|
evas_object_event_callback_list_free(&(obj->callbacks.obj_hide));
|
|
evas_object_event_callback_list_free(&(obj->callbacks.obj_move));
|
|
evas_object_event_callback_list_free(&(obj->callbacks.obj_resize));
|
|
evas_object_event_callback_list_free(&(obj->callbacks.obj_restack));
|
|
}
|
|
|
|
void
|
|
evas_object_event_callback_call(Evas_Object *obj, Evas_Callback_Type type, void *event_info)
|
|
{
|
|
/* MEM OK */
|
|
Evas_Object_List **l_mod, *l;
|
|
|
|
switch (type)
|
|
{
|
|
case EVAS_CALLBACK_MOUSE_IN:
|
|
l_mod = &(obj->callbacks.in);
|
|
break;
|
|
case EVAS_CALLBACK_MOUSE_OUT:
|
|
l_mod = &(obj->callbacks.out);
|
|
break;
|
|
case EVAS_CALLBACK_MOUSE_DOWN:
|
|
l_mod = &(obj->callbacks.down);
|
|
break;
|
|
case EVAS_CALLBACK_MOUSE_UP:
|
|
l_mod = &(obj->callbacks.up);
|
|
break;
|
|
case EVAS_CALLBACK_MOUSE_MOVE:
|
|
l_mod = &(obj->callbacks.move);
|
|
break;
|
|
case EVAS_CALLBACK_FREE:
|
|
l_mod = &(obj->callbacks.free);
|
|
break;
|
|
case EVAS_CALLBACK_KEY_DOWN:
|
|
l_mod = &(obj->callbacks.key_down);
|
|
break;
|
|
case EVAS_CALLBACK_KEY_UP:
|
|
l_mod = &(obj->callbacks.key_up);
|
|
break;
|
|
case EVAS_CALLBACK_FOCUS_IN:
|
|
l_mod = &(obj->callbacks.obj_focus_in);
|
|
break;
|
|
case EVAS_CALLBACK_FOCUS_OUT:
|
|
l_mod = &(obj->callbacks.obj_focus_out);
|
|
break;
|
|
case EVAS_CALLBACK_SHOW:
|
|
l_mod = &(obj->callbacks.obj_show);
|
|
break;
|
|
case EVAS_CALLBACK_HIDE:
|
|
l_mod = &(obj->callbacks.obj_hide);
|
|
break;
|
|
case EVAS_CALLBACK_MOVE:
|
|
l_mod = &(obj->callbacks.obj_move);
|
|
break;
|
|
case EVAS_CALLBACK_RESIZE:
|
|
l_mod = &(obj->callbacks.obj_resize);
|
|
break;
|
|
case EVAS_CALLBACK_RESTACK:
|
|
l_mod = &(obj->callbacks.obj_restack);
|
|
break;
|
|
default:
|
|
return;
|
|
break;
|
|
}
|
|
obj->callbacks.walking_list++;
|
|
for (l = *l_mod; l; l = l->next)
|
|
{
|
|
Evas_Func_Node *fn;
|
|
|
|
fn = (Evas_Func_Node *)l;
|
|
if (!fn->delete_me)
|
|
fn->func(fn->data, obj->layer->evas, obj, event_info);
|
|
if (obj->delete_me) break;
|
|
}
|
|
obj->callbacks.walking_list--;
|
|
if (!obj->callbacks.walking_list)
|
|
evas_object_event_callback_clear(obj);
|
|
}
|
|
|
|
/**
|
|
* Add a callback function to an object
|
|
* @param obj Object to attach a callback to
|
|
* @param type The type of event that will trigger the callback
|
|
* @param func The function to be called when the event is triggered
|
|
* @param data The data pointer to be passed to @p func
|
|
*
|
|
* This function adds a function callback to an object when the event of type
|
|
* @p type occurs on object @p obj. The fucntion is @p func.
|
|
*
|
|
* In the event of a memory allocation error during addition of the callback to
|
|
* the object, evas_alloc_error() should be used to determine the nature of
|
|
* the error, if any, and the program should sensibly try and recover.
|
|
*
|
|
* The function will be passed the pointer @p data when it is called. A
|
|
* callback function must look like this:
|
|
*
|
|
* @code
|
|
* void callback (void *data, Evas *e, Evas_Object *obj, void *event_info);
|
|
* @endcode
|
|
*
|
|
* The first parameter @p data in this function will be the same value passed
|
|
* to evas_object_event_callback_add() as the @p data parameter. The second
|
|
* parameter is a convenience for the programmer to know what evas canvas the
|
|
* event occured on. The third parameter @p obj is the Object handle on which
|
|
* the event occured. The foruth parameter @p event_info is a pointer to a
|
|
* data structure that may or may not be passed to the callback, depending on
|
|
* the event type that triggered the callback.
|
|
*
|
|
* The event type @p type to trigger the function mys be one of
|
|
* EVAS_CALLBACK_MOUSE_IN, EVAS_CALLBACK_MOUSE_OUT, EVAS_CALLBACK_MOUSE_DOWN,
|
|
* EVAS_CALLBACK_MOUSE_UP, EVAS_CALLBACK_MOUSE_MOVE, EVAS_CALLBACK_FREE,
|
|
* EVAS_CALLBACK_KEY_DOWN, EVAS_CALLBACK_KEY_UP, EVAS_CALLBACK_FOCUS_IN,
|
|
* EVAS_CALLBACK_FOCUS_OUT, EVAS_CALLBACK_SHOW, EVAS_CALLBACK_HIDE,
|
|
* EVAS_CALLBACK_MOVE, EVAS_CALLBACK_RESIZE or EVAS_CALLBACK_RESTACK. This
|
|
* determines the kind of event that will trigger the callback to be called.
|
|
* The @p event_info pointer passed to the callback will be one of the
|
|
* following, depending on the event tiggering it:
|
|
*
|
|
* EVAS_CALLBACK_MOUSE_IN: event_info = pointer to Evas_Event_Mouse_In
|
|
*
|
|
* This event is triggered when the mouse pointer enters the region of
|
|
* the object @p obj. This may occur by the mouse pointer being moved by
|
|
* evas_event_feed_mouse_move() or evas_event_feed_mouse_move_data() calls,
|
|
* or by the object being shown, raised, moved, resized, or other objects
|
|
* being moved out of the way, hidden, lowered or moved out of the way.
|
|
*
|
|
* In the event structure whose pointer is passed to the callback, the
|
|
* following members indicate the following:
|
|
*
|
|
* EVAS_CALLBACK_MOUSE_OUT: event_info = pointer to Evas_Event_Mouse_Out
|
|
*
|
|
* This event is triggered exactly like EVAS_CALLBACK_MOUSE_IN is, but occurs
|
|
* when the mouse pointer exits an object. Note that no out events will be
|
|
* reported if the mouse pointer is implicitly grabbed to an object (the
|
|
* mouse buttons are down at all and any were pressed on that object). An
|
|
* out event will be reported as soon as the mouse is no longer grabbed
|
|
* (no mouse buttons are depressed). Out events will be reported if the mouse
|
|
* has left the object once all buttons are released.
|
|
*
|
|
* EVAS_CALLBACK_MOUSE_DOWN: event_info = pointer to Evas_Event_Mouse_Down
|
|
*
|
|
* This event is triggered by a mouse button being depressed while over an
|
|
* object. This will passively lock all events to that object until all mouse
|
|
* buttons have been released. That means if this mouse button is the first
|
|
* to be pressed, all future button presses will be reported to this object
|
|
* only until no buttons are down. That includes mouse move events, in and out
|
|
* events. On all buttons being release, event propagation processed as normal.
|
|
*
|
|
* EVAS_CALLBACK_MOUSE_UP: event_info = pointer to Evas_Event_Mouse_Up
|
|
*
|
|
* This event is driggered by a mouse button being released while over an
|
|
* object or when passively grabbed to an object. If this is the last mouse
|
|
* button to be raised on an object then the passive grab is released and
|
|
* event processing will continue as normal.
|
|
*
|
|
* EVAS_CALLBACK_MOUSE_MOVE: event_info = pointer to Evas_Event_Mouse_Move
|
|
*
|
|
* This event is triggered by the mouse pointer moving while over an object or
|
|
* passively grabbed to an object.
|
|
*
|
|
* EVAS_CALLBACK_FREE: event_info = NULL
|
|
*
|
|
* This event is triggered just before Evas is about to free all memory used
|
|
* by an object and remove all references to it. This is useful for programs
|
|
* to sue if they attached data to an object and want to free it when the
|
|
* object is deleted. The object is still valid when this callback is called,
|
|
* but after this callback returns, there is no guarantee on the object's
|
|
* validity.
|
|
*
|
|
* EVAS_CALLBACK_KEY_DOWN: event_info = pointer to Evas_Event_Key_Down
|
|
*
|
|
* This callback is called when a key is pressed and the focus is on the
|
|
* object, or a key has been grabbed to a particular object which wants to
|
|
* intercept the key press regardless of what object has the focus.
|
|
*
|
|
* EVAS_CALLBACK_KEY_UP: event_info = pointer to Evas_Event_Key_Up
|
|
*
|
|
* This callback is called when a key is released and the focus is on the
|
|
* object, or a key has been grabbed to a particular object which wants to
|
|
* intercept the key release regardless of what object has the focus.
|
|
*
|
|
* EVAS_CALLBACK_FOCUS_IN: event_info = NULL
|
|
*
|
|
* This event is called when an object gains the focus. When the callback is
|
|
* called the object has already gained the focus.
|
|
*
|
|
* EVAS_CALLBACK_FOCUS_OUT: event_info = NULL
|
|
*
|
|
* This event is triggered by an object losing the focus. When the callback is
|
|
* called the object has already lost the focus.
|
|
*
|
|
* EVAS_CALLBACK_SHOW: event_info = NULL
|
|
*
|
|
* This event is triggered being shown by evas_object_show().
|
|
*
|
|
* EVAS_CALLBACK_HIDE: event_info = NULL
|
|
*
|
|
* This event is triggered by an object being hidden by evas_object_hide().
|
|
*
|
|
* EVAS_CALLBACK_MOVE: event_info = NULL
|
|
*
|
|
* This event is triggered by an object being moved. evas_object_move() can
|
|
* trigger this, as can any object specific manipulations that would mean the
|
|
* objects origin could move.
|
|
*
|
|
* EVAS_CALLBACK_RESIZE: event_info = NULL
|
|
*
|
|
* This event is triggered by an object being resized. Resizes can be
|
|
* triggered by evas_object_resize() or by any object specific calls that may
|
|
* cause the object to resize.
|
|
*
|
|
* Example:
|
|
* @code
|
|
* extern Evas_Object *object;
|
|
* extern void *my_data;
|
|
* void down_callback(void *data, Evas *e, Evas_Object *obj, void *event_info);
|
|
* void up_callback(void *data, Evas *e, Evas_Object *obj, void *event_info);
|
|
*
|
|
* evas_object_event_callback_add(object, EVAS_CALLBACK_MOUSE_UP, up_callback, my_data);
|
|
* if (evas_alloc_error() != EVAS_ALLOC_ERROR_NONE)
|
|
* {
|
|
* fprintf(stderr, "ERROR: Callback registering failed! Abort!\n");
|
|
* exit(-1);
|
|
* }
|
|
* evas_object_event_callback_add(object, EVAS_CALLBACK_MOUSE_DOWN, down_callback, my_data);
|
|
* if (evas_alloc_error() != EVAS_ALLOC_ERROR_NONE)
|
|
* {
|
|
* fprintf(stderr, "ERROR: Callback registering failed! Abort!\n");
|
|
* exit(-1);
|
|
* }
|
|
* @endcode
|
|
*/
|
|
void
|
|
evas_object_event_callback_add(Evas_Object *obj, Evas_Callback_Type type, void (*func) (void *data, Evas *e, Evas_Object *obj, void *event_info), const void *data)
|
|
{
|
|
/* MEM OK */
|
|
Evas_Func_Node *fn;
|
|
Evas_Object_List **l_mod;
|
|
|
|
MAGIC_CHECK(obj, Evas_Object, MAGIC_OBJ);
|
|
return;
|
|
MAGIC_CHECK_END();
|
|
|
|
if (!func) return;
|
|
|
|
fn = evas_mem_calloc(sizeof(Evas_Func_Node));
|
|
if (!fn) return;
|
|
fn->func = func;
|
|
fn->data = (void *)data;
|
|
|
|
switch (type)
|
|
{
|
|
case EVAS_CALLBACK_MOUSE_IN:
|
|
l_mod = &(obj->callbacks.in);
|
|
break;
|
|
case EVAS_CALLBACK_MOUSE_OUT:
|
|
l_mod = &(obj->callbacks.out);
|
|
break;
|
|
case EVAS_CALLBACK_MOUSE_DOWN:
|
|
l_mod = &(obj->callbacks.down);
|
|
break;
|
|
case EVAS_CALLBACK_MOUSE_UP:
|
|
l_mod = &(obj->callbacks.up);
|
|
break;
|
|
case EVAS_CALLBACK_MOUSE_MOVE:
|
|
l_mod = &(obj->callbacks.move);
|
|
break;
|
|
case EVAS_CALLBACK_FREE:
|
|
l_mod = &(obj->callbacks.free);
|
|
break;
|
|
case EVAS_CALLBACK_KEY_DOWN:
|
|
l_mod = &(obj->callbacks.key_down);
|
|
break;
|
|
case EVAS_CALLBACK_KEY_UP:
|
|
l_mod = &(obj->callbacks.key_up);
|
|
break;
|
|
case EVAS_CALLBACK_FOCUS_IN:
|
|
l_mod = &(obj->callbacks.obj_focus_in);
|
|
break;
|
|
case EVAS_CALLBACK_FOCUS_OUT:
|
|
l_mod = &(obj->callbacks.obj_focus_out);
|
|
break;
|
|
case EVAS_CALLBACK_SHOW:
|
|
l_mod = &(obj->callbacks.obj_show);
|
|
break;
|
|
case EVAS_CALLBACK_HIDE:
|
|
l_mod = &(obj->callbacks.obj_hide);
|
|
break;
|
|
case EVAS_CALLBACK_MOVE:
|
|
l_mod = &(obj->callbacks.obj_move);
|
|
break;
|
|
case EVAS_CALLBACK_RESIZE:
|
|
l_mod = &(obj->callbacks.obj_resize);
|
|
break;
|
|
case EVAS_CALLBACK_RESTACK:
|
|
l_mod = &(obj->callbacks.obj_restack);
|
|
break;
|
|
default:
|
|
free(fn);
|
|
return;
|
|
break;
|
|
}
|
|
*l_mod = evas_object_list_append(*l_mod, fn);
|
|
}
|
|
|
|
/**
|
|
* Add a callback function to an object
|
|
* @param obj Object to remove a callback from
|
|
* @param type The type of event that was triggering the callback
|
|
* @param func The function that was to be called when the event was triggered
|
|
* @return The data pointer that was to be passwd to the callback
|
|
*
|
|
* This function removes the most recently added callback from the object
|
|
* @p obj which was triggered by the event type @p type and was calling the
|
|
* function @p func when triggered. If the callback is successful it will also
|
|
* return the data pointer, passed to evas_object_event_callback_add() when
|
|
* the callback was added to the object. If not successful NULL will be
|
|
* returned.
|
|
*
|
|
* Example:
|
|
* @code
|
|
* extern Evas_Object *object;
|
|
* void *my_data;
|
|
* void up_callback(void *data, Evas *e, Evas_Object *obj, void *event_info);
|
|
*
|
|
* my_data = evas_object_event_callback_del(object, EVAS_CALLBACK_MOUSE_UP, up_callback);
|
|
* @endcode
|
|
*/
|
|
void *
|
|
evas_object_event_callback_del(Evas_Object *obj, Evas_Callback_Type type, void (*func) (void *data, Evas *e, Evas_Object *obj, void *event_info))
|
|
{
|
|
/* MEM OK */
|
|
Evas_Object_List **l_mod, *l;
|
|
|
|
MAGIC_CHECK(obj, Evas_Object, MAGIC_OBJ);
|
|
return NULL;
|
|
MAGIC_CHECK_END();
|
|
|
|
if (!func) return NULL;
|
|
|
|
switch (type)
|
|
{
|
|
case EVAS_CALLBACK_MOUSE_IN:
|
|
l_mod = &(obj->callbacks.in);
|
|
break;
|
|
case EVAS_CALLBACK_MOUSE_OUT:
|
|
l_mod = &(obj->callbacks.out);
|
|
break;
|
|
case EVAS_CALLBACK_MOUSE_DOWN:
|
|
l_mod = &(obj->callbacks.down);
|
|
break;
|
|
case EVAS_CALLBACK_MOUSE_UP:
|
|
l_mod = &(obj->callbacks.up);
|
|
break;
|
|
case EVAS_CALLBACK_MOUSE_MOVE:
|
|
l_mod = &(obj->callbacks.move);
|
|
break;
|
|
case EVAS_CALLBACK_FREE:
|
|
l_mod = &(obj->callbacks.free);
|
|
break;
|
|
case EVAS_CALLBACK_KEY_DOWN:
|
|
l_mod = &(obj->callbacks.key_down);
|
|
break;
|
|
case EVAS_CALLBACK_KEY_UP:
|
|
l_mod = &(obj->callbacks.key_up);
|
|
break;
|
|
case EVAS_CALLBACK_FOCUS_IN:
|
|
l_mod = &(obj->callbacks.obj_focus_in);
|
|
break;
|
|
case EVAS_CALLBACK_FOCUS_OUT:
|
|
l_mod = &(obj->callbacks.obj_focus_out);
|
|
break;
|
|
case EVAS_CALLBACK_SHOW:
|
|
l_mod = &(obj->callbacks.obj_show);
|
|
break;
|
|
case EVAS_CALLBACK_HIDE:
|
|
l_mod = &(obj->callbacks.obj_hide);
|
|
break;
|
|
case EVAS_CALLBACK_MOVE:
|
|
l_mod = &(obj->callbacks.obj_move);
|
|
break;
|
|
case EVAS_CALLBACK_RESIZE:
|
|
l_mod = &(obj->callbacks.obj_resize);
|
|
break;
|
|
case EVAS_CALLBACK_RESTACK:
|
|
l_mod = &(obj->callbacks.obj_restack);
|
|
break;
|
|
default:
|
|
return NULL;
|
|
break;
|
|
}
|
|
for (l = *l_mod; l; l = l->next)
|
|
{
|
|
Evas_Func_Node *fn;
|
|
|
|
fn = (Evas_Func_Node *)l;
|
|
if (fn->func == func)
|
|
{
|
|
void *data;
|
|
|
|
data = fn->data;
|
|
fn->delete_me = 1;
|
|
obj->callbacks.deletions_waiting = 1;
|
|
if (!obj->callbacks.walking_list)
|
|
evas_object_event_callback_clear(obj);
|
|
return data;
|
|
}
|
|
}
|
|
return NULL;
|
|
}
|