diff options
author | Jean-Philippe Andre <jp.andre@samsung.com> | 2017-02-16 16:25:50 +0900 |
---|---|---|
committer | Jean-Philippe Andre <jp.andre@samsung.com> | 2017-02-16 16:25:50 +0900 |
commit | 5335352eda4f4e1fe11c0aace94d9e6c1c2e87b9 (patch) | |
tree | ca274bc3cc730825a508f96a365c441db24a73ef | |
parent | 0a28cb97af928623127644e37a522af36035a845 (diff) | |
download | efl-5335352eda4f4e1fe11c0aace94d9e6c1c2e87b9.tar.gz |
evas/doc: Add warning about post_event_callback_push
-rw-r--r-- | src/lib/evas/Evas_Legacy.h | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/src/lib/evas/Evas_Legacy.h b/src/lib/evas/Evas_Legacy.h index 214060960b..3ed05abfb8 100644 --- a/src/lib/evas/Evas_Legacy.h +++ b/src/lib/evas/Evas_Legacy.h @@ -218,6 +218,14 @@ EAPI void *evas_event_callback_del_full(Evas *e, Evas_Callback_Type type, Evas_E * callback prepares information ready for taking action, but the post callback * actually does the action). * + * This function should only be called from inside an evas input event + * callback. The event_info data may be kept up until @p func is called, in + * order to check the state of the "on-hold" flag for instance. Do not modify + * the canvas or otherwise trigger or feed a events to the canvas from inside + * @p func. Use jobs to safely modify the canvas. + * + * @warning Only use this function if you know exactly what you are doing! + * */ EAPI void evas_post_event_callback_push(Evas *e, Evas_Object_Event_Post_Cb func, const void *data); |