Tizen Native API  4.0
Efl Extension Event

This module provides functionalities to handle back/send key events.

Since :
2.3

Functions

static void eext_popup_back_cb (void *data, Evas_Object *obj, void *event_info)
 Convenient macro function that sends back key events to the popup to be removed.
static void eext_ctxpopup_back_cb (void *data, Evas_Object *obj, void *event_info)
 Convenient macro function that sends back key events to the ctxpopup to be dismissed.
static void eext_naviframe_more_cb (void *data, Evas_Object *obj, void *event_info)
 Convenient macro function that sends more key events to the naviframe top item.
static void eext_naviframe_back_cb (void *data, Evas_Object *obj, void *event_info)
 Convenient macro function that pop the naviframe item.
void * eext_object_event_callback_del (Evas_Object *obj, Eext_Callback_Type type, Eext_Event_Cb func)
 Delete a callback function from an object.
void eext_object_event_callback_add (Evas_Object *obj, Eext_Callback_Type type, Eext_Event_Cb func, void *data)
 Add (register) a callback function to a given evas object.
static void eext_entry_back_cb (void *data, Evas_Object *obj, void *event_info)
 Convenient macro function that cancels the selection of the entry.
static void eext_entry_selection_start_cb (void *data, Evas_Object *obj, void *event_info)
 Convenient macro function that registers back key callback for entry.
static void eext_entry_selection_cleared_cb (void *data, Evas_Object *obj, void *event_info)
 Convenient macro function that clears back key callback for entry.
static void eext_entry_selection_back_event_allow_set (Evas_Object *obj, Eina_Bool allow)
 Convenient macro function that handle the back event to cancel the selection handler of the entry.
void eext_gesture_event_dispatch (Eext_Gesture_Event_Type type, int x, int y)
 Dispatch gesture event given type and x, y position.

Typedefs

typedef enum _Eext_Callback_Type Eext_Callback_Type
typedef void(* Eext_Event_Cb )(void *data, Evas_Object *obj, void *event_info)
 Ea event callback function signature.
typedef enum
_Eext_Gesture_Event_Type 
Eext_Gesture_Event_Type

Typedef Documentation

Identifier of callbacks to be set for Ea events.

See also:
eext_object_event_callback_add()
eext_object_event_callback_del()
Since :
2.3.1
typedef void(* Eext_Event_Cb)(void *data, Evas_Object *obj, void *event_info)

Ea event callback function signature.

Parameters:
[in]datauser data
[in]objtarget object
[in]event_infoevent information (if the event passes an additional in formation.)
See also:
eext_object_event_callback_add()
Since :
2.3.1

An enum of gesture type


Enumeration Type Documentation

Identifier of callbacks to be set for Ea events.

See also:
eext_object_event_callback_add()
eext_object_event_callback_del()
Since :
2.3.1
Enumerator:
EEXT_CALLBACK_BACK 

H/W Back Key Event

EEXT_CALLBACK_MORE 

H/W More Key Event

EEXT_CALLBACK_LAST 

Reserved value. Acutally This is not matched to any meaningful behavior.

An enum of gesture type

Enumerator:
EEXT_GESTURE_TAP 

Tap Gesture

EEXT_GESTURE_SWIPE_RIGHT 

Swipe Right Gesutre

EEXT_GESTURE_SWIPE_LEFT 

Swipe Left Gesutre

EEXT_GESTURE_SWIPE_UP 

Swipe Up Gesutre

EEXT_GESTURE_SWIPE_DOWN 

Swipe Down Gesutre

EEXT_GESTURE_ZOOM_IN 

Zoom In Gesutre

EEXT_GESTURE_ZOOM_OUT 

Zoom Out Gesutre


Function Documentation

static void eext_ctxpopup_back_cb ( void *  data,
Evas_Object obj,
void *  event_info 
) [static]

Convenient macro function that sends back key events to the ctxpopup to be dismissed.

Ctxpopup will be dismissed when it has the back key event with eext_object_event_callback_add()

Parameters:
[in]datauser data
[in]objtarget object
[in]event_infoevent information
See also:
eext_object_event_callback_add()
Since :
2.3.1
static void eext_entry_back_cb ( void *  data,
Evas_Object obj,
void *  event_info 
) [static]

Convenient macro function that cancels the selection of the entry.

Parameters:
[in]datauser data
[in]objtarget object
[in]event_infoevent information
See also:
eext_entry_selection_back_event_allow_set()
Since :
2.3.1
static void eext_entry_selection_back_event_allow_set ( Evas_Object obj,
Eina_Bool  allow 
) [static]

Convenient macro function that handle the back event to cancel the selection handler of the entry.

If the selection handler should be canceled (or not) when back key event is triggered, then use this API.

Parameters:
[in]objEntry object.
[in]allowEINA_TRUE allows the back event handling, EINA_FALSE otherwise.
See also:
eext_object_event_callback_add()
eext_object_event_callback_del()
Since :
2.3.1
static void eext_entry_selection_cleared_cb ( void *  data,
Evas_Object obj,
void *  event_info 
) [static]

Convenient macro function that clears back key callback for entry.

Parameters:
[in]datauser data
[in]objtarget object
[in]event_infoevent information
See also:
eext_entry_selection_back_event_allow_set()
eext_object_event_callback_add()
Since :
2.3.1
static void eext_entry_selection_start_cb ( void *  data,
Evas_Object obj,
void *  event_info 
) [static]

Convenient macro function that registers back key callback for entry.

If the selection handler should be canceled when back key event is triggered, then use this API.

Parameters:
[in]datauser data
[in]objtarget object
[in]event_infoevent information
See also:
eext_entry_selection_back_event_allow_set()
Since :
2.3.1
void eext_gesture_event_dispatch ( Eext_Gesture_Event_Type  type,
int  x,
int  y 
)

Dispatch gesture event given type and x, y position.

Parameters:
[in]typeGesture type
[in]xThe x coordinate gesture event starts at
[in]yThe y coordinate gesture event starts at
static void eext_naviframe_back_cb ( void *  data,
Evas_Object obj,
void *  event_info 
) [static]

Convenient macro function that pop the naviframe item.

Naviframe will be popped when naviframe has the back key event with eext_object_event_callback_add()

Parameters:
[in]datauser data
[in]objtarget object
[in]event_infoevent information
See also:
eext_object_event_callback_add()
Since :
2.3.1
static void eext_naviframe_more_cb ( void *  data,
Evas_Object obj,
void *  event_info 
) [static]

Convenient macro function that sends more key events to the naviframe top item.

More key action of naviframe will be executed when naviframe has the more key event with eext_object_event_callback_add()

Parameters:
[in]datauser data
[in]objtarget object
[in]event_infoevent information
See also:
eext_object_event_callback_add()
Since :
2.3.1
void eext_object_event_callback_add ( Evas_Object obj,
Eext_Callback_Type  type,
Eext_Event_Cb  func,
void *  data 
)

Add (register) a callback function to a given evas object.

This function adds a function callback to an object when the key event occurs on object obj. The key event on the object is only triggered when the object is the most top in objects stack and visible. This means, like the naviframe widget, if your application needs to have the events based on the view but not focus, you can use this callback. A callback function must have the Eext_Event_Cb prototype definition. The first parameter (data) in this definition will have the same value passed to eext_object_event_callback_add() as the data parameter, at runtime. The second parameter obj is the evas object on which event occurred. Finally, the third parameter 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. This is so because some events don't carry extra context with them, but others do.

Parameters:
[in]objevas object.
[in]typeThe type of event that will trigger the callback.
[in]funcThe function to be called when the key event is triggered.
[in]dataThe data pointer to be passed to func.
See also:
eext_object_event_callback_del()
Since :
2.3.1

Delete a callback function from an object.

This function removes the most recently added callback from the object obj which was triggered by the type type and was calling the function func when triggered. If the removal is successful it will also return the data pointer that was passed to eext_object_event_callback_add() when the callback was added to the object. If not successful NULl will be returned.

Parameters:
[in]objObject to remove a callback from.
[in]typeThe type of event that was triggering the callback.
[in]funcThe function that was to be called when the event was triggered
Returns:
data The data pointer that was to be passed to the callback.
See also:
eext_object_event_callback_add()
Since :
2.3.1
static void eext_popup_back_cb ( void *  data,
Evas_Object obj,
void *  event_info 
) [static]

Convenient macro function that sends back key events to the popup to be removed.

Popup will be removed when it has the back key event with eext_object_event_callback_add()

Parameters:
[in]datauser data
[in]objtarget object
[in]event_infoevent information
See also:
eext_object_event_callback_add()
Since :
2.3.1