summaryrefslogtreecommitdiff
path: root/src/lib/ecore_imf/Ecore_IMF.h
diff options
context:
space:
mode:
authorJihoon Kim <imfine98@gmail.com>2013-01-29 02:43:42 +0000
committerJihoon Kim <imfine98@gmail.com>2013-01-29 02:43:42 +0000
commitaee571bf18ead564fed819a9f558ffc600a51464 (patch)
tree50f58b09a6d3cb74f2696d966458dd23429b9363 /src/lib/ecore_imf/Ecore_IMF.h
parent73694511ded180ed9a456ca55f067da5547737da (diff)
efl/ecore_imf: supplement the document about ecore_imf_context_cursor_position_set and ecore_imf_context_reset
SVN revision: 83396
Diffstat (limited to 'src/lib/ecore_imf/Ecore_IMF.h')
-rw-r--r--src/lib/ecore_imf/Ecore_IMF.h19
1 files changed, 15 insertions, 4 deletions
diff --git a/src/lib/ecore_imf/Ecore_IMF.h b/src/lib/ecore_imf/Ecore_IMF.h
index be24897d29..c405e7918a 100644
--- a/src/lib/ecore_imf/Ecore_IMF.h
+++ b/src/lib/ecore_imf/Ecore_IMF.h
@@ -766,11 +766,11 @@ EAPI void ecore_imf_context_preedit_string_with_attribu
766 * static void 766 * static void
767 * _focus_in_cb(void *data, Evas_Object *o, const char *emission, const char *source) 767 * _focus_in_cb(void *data, Evas_Object *o, const char *emission, const char *source)
768 * { 768 * {
769 * ecore_imf_context_reset(imf_context); 769 * Ecore_IMF_Context *imf_context = data;
770 * ecore_imf_context_focus_in(imf_context); 770 * ecore_imf_context_focus_in(imf_context);
771 * } 771 * }
772 * 772 *
773 * evas_object_event_callback_add(obj, EVAS_CALLBACK_FOCUS_IN, _focus_in_cb, ed); 773 * evas_object_event_callback_add(obj, EVAS_CALLBACK_FOCUS_IN, _focus_in_cb, imf_context);
774 * @endcode 774 * @endcode
775 */ 775 */
776EAPI void ecore_imf_context_focus_in(Ecore_IMF_Context *ctx); 776EAPI void ecore_imf_context_focus_in(Ecore_IMF_Context *ctx);
@@ -787,6 +787,7 @@ EAPI void ecore_imf_context_focus_in(Ecore_IMF_Context
787 * static void 787 * static void
788 * _focus_out_cb(void *data, Evas_Object *o, const char *emission, const char *source) 788 * _focus_out_cb(void *data, Evas_Object *o, const char *emission, const char *source)
789 * { 789 * {
790 * Ecore_IMF_Context *imf_context = data;
790 * ecore_imf_context_reset(imf_context); 791 * ecore_imf_context_reset(imf_context);
791 * ecore_imf_context_focus_out(imf_context); 792 * ecore_imf_context_focus_out(imf_context);
792 * } 793 * }
@@ -799,7 +800,14 @@ EAPI void ecore_imf_context_focus_out(Ecore_IMF_Context
799/** 800/**
800 * Notify the Input Method Context that a change such as a 801 * Notify the Input Method Context that a change such as a
801 * change in cursor position has been made. This will typically 802 * change in cursor position has been made. This will typically
802 * cause the Input Method Context to clear the preedit state. 803 * cause the Input Method Context to clear the preedit state or commit the preedit string.
804 *
805 * The operation of ecore_imf_context_reset() depends on the specific characteristics of
806 * each langauge. For example, the preedit string is cleared in the Chinese and Japanese Input Method Engine.
807 * However, The preedit string is committed and then cleared in the Korean Input Method Engine.
808 *
809 * This function should be called in case of the focus-out and mouse down event callback function.
810 * In addition, it should be called before inserting some text.
803 * 811 *
804 * @param ctx An #Ecore_IMF_Context. 812 * @param ctx An #Ecore_IMF_Context.
805 * @ingroup Ecore_IMF_Context_Group 813 * @ingroup Ecore_IMF_Context_Group
@@ -809,11 +817,12 @@ EAPI void ecore_imf_context_focus_out(Ecore_IMF_Context
809 * static void 817 * static void
810 * _focus_out_cb(void *data, Evas_Object *o, const char *emission, const char *source) 818 * _focus_out_cb(void *data, Evas_Object *o, const char *emission, const char *source)
811 * { 819 * {
820 * Ecore_IMF_Context *imf_context = data;
812 * ecore_imf_context_reset(imf_context); 821 * ecore_imf_context_reset(imf_context);
813 * ecore_imf_context_focus_out(imf_context); 822 * ecore_imf_context_focus_out(imf_context);
814 * } 823 * }
815 * 824 *
816 * evas_object_event_callback_add(obj, EVAS_CALLBACK_FOCUS_OUT, _focus_out_cb, ed); 825 * evas_object_event_callback_add(obj, EVAS_CALLBACK_FOCUS_OUT, _focus_out_cb, imf_context);
817 * @endcode 826 * @endcode
818 */ 827 */
819EAPI void ecore_imf_context_reset(Ecore_IMF_Context *ctx); 828EAPI void ecore_imf_context_reset(Ecore_IMF_Context *ctx);
@@ -822,6 +831,8 @@ EAPI void ecore_imf_context_reset(Ecore_IMF_Context *ct
822 * Notify the Input Method Context that a change in the cursor 831 * Notify the Input Method Context that a change in the cursor
823 * position has been made. 832 * position has been made.
824 * 833 *
834 * This function should be called when cursor position is changed or mouse up event is generated.
835 *
825 * @param ctx An #Ecore_IMF_Context. 836 * @param ctx An #Ecore_IMF_Context.
826 * @param cursor_pos New cursor position in characters. 837 * @param cursor_pos New cursor position in characters.
827 * @ingroup Ecore_IMF_Context_Group 838 * @ingroup Ecore_IMF_Context_Group