An Input Method Context

An Input Method Context class

An Input Method Context info

A general class of device

Since (EFL) :

1.14

A general subclass of device

Since (EFL) :

1.14

Called when a Ecore_IMF event happens.

See also:

ecore_imf_context_event_callback_add()

Enumerator:

ECORE_IMF_INPUT_PANEL_LAYOUT_NORMAL_VARIATION_NORMAL	The plain normal layout Since (EFL) : 1.12
ECORE_IMF_INPUT_PANEL_LAYOUT_NORMAL_VARIATION_FILENAME	Filename layout. Symbols such as '/' should be disabled. Since (EFL) : 1.12
ECORE_IMF_INPUT_PANEL_LAYOUT_NORMAL_VARIATION_PERSON_NAME	The name of a person. Since (EFL) : 1.12

Enumerator:

ECORE_IMF_INPUT_PANEL_LAYOUT_NUMBERONLY_VARIATION_NORMAL	The plain normal number layout Since (EFL) : 1.8
ECORE_IMF_INPUT_PANEL_LAYOUT_NUMBERONLY_VARIATION_SIGNED	The number layout to allow a positive or negative sign at the start Since (EFL) : 1.8
ECORE_IMF_INPUT_PANEL_LAYOUT_NUMBERONLY_VARIATION_DECIMAL	The number layout to allow decimal point to provide fractional value Since (EFL) : 1.8
ECORE_IMF_INPUT_PANEL_LAYOUT_NUMBERONLY_VARIATION_SIGNED_AND_DECIMAL	The number layout to allow decimal point and negative sign Since (EFL) : 1.8

Enumerator:

ECORE_IMF_INPUT_PANEL_LAYOUT_PASSWORD_VARIATION_NORMAL	The normal password layout Since (EFL) : 1.12
ECORE_IMF_INPUT_PANEL_LAYOUT_PASSWORD_VARIATION_NUMBERONLY	The password layout to allow only number Since (EFL) : 1.12

Enumerator:

ECORE_IMF_DEVICE_CLASS_NONE	Not a device Since (EFL) : 1.14
ECORE_IMF_DEVICE_CLASS_SEAT	The user/seat (the user themselves) Since (EFL) : 1.14
ECORE_IMF_DEVICE_CLASS_KEYBOARD	A regular keyboard, numberpad or attached buttons Since (EFL) : 1.14
ECORE_IMF_DEVICE_CLASS_MOUSE	A mouse, trackball or touchpad relative motion device Since (EFL) : 1.14
ECORE_IMF_DEVICE_CLASS_TOUCH	A touchscreen with fingers or stylus Since (EFL) : 1.14
ECORE_IMF_DEVICE_CLASS_PEN	A special pen device Since (EFL) : 1.14
ECORE_IMF_DEVICE_CLASS_POINTER	A laser pointer, wii-style or "minority report" pointing device Since (EFL) : 1.14
ECORE_IMF_DEVICE_CLASS_GAMEPAD	A gamepad controller or joystick Since (EFL) : 1.14

Enumerator:

ECORE_IMF_DEVICE_SUBCLASS_NONE	Not a device Since (EFL) : 1.14
ECORE_IMF_DEVICE_SUBCLASS_FINGER	The normal flat of your finger Since (EFL) : 1.14
ECORE_IMF_DEVICE_SUBCLASS_FINGERNAIL	A fingernail Since (EFL) : 1.14
ECORE_IMF_DEVICE_SUBCLASS_KNUCKLE	A Knuckle Since (EFL) : 1.14
ECORE_IMF_DEVICE_SUBCLASS_PALM	The palm of a users hand Since (EFL) : 1.14
ECORE_IMF_DEVICE_SUBCLASS_HAND_SIZE	The side of your hand Since (EFL) : 1.14
ECORE_IMF_DEVICE_SUBCLASS_HAND_FLAT	The flat of your hand Since (EFL) : 1.14
ECORE_IMF_DEVICE_SUBCLASS_PEN_TIP	The tip of a pen Since (EFL) : 1.14
ECORE_IMF_DEVICE_SUBCLASS_TRACKPAD	A trackpad style mouse Since (EFL) : 1.14
ECORE_IMF_DEVICE_SUBCLASS_TRACKPOINT	A trackpoint style mouse Since (EFL) : 1.14
ECORE_IMF_DEVICE_SUBCLASS_TRACKBALL	A trackball style mouse Since (EFL) : 1.14
ECORE_IMF_DEVICE_SUBCLASS_REMOCON	A remote controller Since : 4.0
ECORE_IMF_DEVICE_SUBCLASS_VIRTUAL_KEYBOARD	A virtual keyboard Since : 4.0

Autocapitalization Types.

See also:

ecore_imf_context_autocapital_type_set()

Enumerator:

ECORE_IMF_AUTOCAPITAL_TYPE_NONE	No auto-capitalization when typing Since (EFL) : 1.1
ECORE_IMF_AUTOCAPITAL_TYPE_WORD	Autocapitalize each word typed Since (EFL) : 1.1
ECORE_IMF_AUTOCAPITAL_TYPE_SENTENCE	Autocapitalize the start of each sentence Since (EFL) : 1.1
ECORE_IMF_AUTOCAPITAL_TYPE_ALLCHARACTER	Autocapitalize all letters Since (EFL) : 1.1

Enumeration for defining the types of Ecore_IMF bidirectionality.

Since (EFL) :

1.12

Enumerator:

ECORE_IMF_BIDI_DIRECTION_NEUTRAL	The Neutral mode Since (EFL) : 1.12
ECORE_IMF_BIDI_DIRECTION_LTR	The Left to Right mode Since (EFL) : 1.12
ECORE_IMF_BIDI_DIRECTION_RTL	The Right to Left mode Since (EFL) : 1.12

Ecore IMF Event callback types.

See also:

ecore_imf_context_event_callback_add()

Enumerator:

ECORE_IMF_CALLBACK_PREEDIT_START	"PREEDIT_START" is called when a new preediting sequence starts. Since (EFL) : 1.2
ECORE_IMF_CALLBACK_PREEDIT_END	"PREEDIT_END" is called when a preediting sequence has been completed or canceled. Since (EFL) : 1.2
ECORE_IMF_CALLBACK_PREEDIT_CHANGED	"PREEDIT_CHANGED" is called whenever the preedit sequence currently being entered has changed. Since (EFL) : 1.2
ECORE_IMF_CALLBACK_COMMIT	"COMMIT" is called when a complete input sequence has been entered by the user Since (EFL) : 1.2
ECORE_IMF_CALLBACK_DELETE_SURROUNDING	"DELETE_SURROUNDING" is called when the input method needs to delete all or part of the context surrounding the cursor Since (EFL) : 1.2
ECORE_IMF_CALLBACK_SELECTION_SET	"SELECTION_SET" is called when the input method needs to set the selection Since (EFL) : 1.9
ECORE_IMF_CALLBACK_PRIVATE_COMMAND_SEND	"PRIVATE_COMMAND_SEND" is called when the input method sends a private command Since (EFL) : 1.12
ECORE_IMF_CALLBACK_COMMIT_CONTENT	"COMMIT_CONTENT" is called when the input method commits content such as an image Since (EFL) : 1.20

Enum containing candidate word panel state notifications.

Enumerator:

ECORE_IMF_CANDIDATE_PANEL_SHOW	Notification after the display of the candidate word panel Since (EFL) : 1.7
ECORE_IMF_CANDIDATE_PANEL_HIDE	Notification prior to the dismissal of the candidate word panel Since (EFL) : 1.7

Ecore IMF event types.

See also:

ecore_imf_context_filter_event()

Enumerator:

ECORE_IMF_EVENT_MOUSE_DOWN	Mouse Down event
ECORE_IMF_EVENT_MOUSE_UP	Mouse Up event
ECORE_IMF_EVENT_MOUSE_IN	Mouse In event
ECORE_IMF_EVENT_MOUSE_OUT	Mouse Out event
ECORE_IMF_EVENT_MOUSE_MOVE	Mouse Move event
ECORE_IMF_EVENT_MOUSE_WHEEL	Mouse Wheel event
ECORE_IMF_EVENT_KEY_DOWN	Key Down event
ECORE_IMF_EVENT_KEY_UP	Key Up event

Enumeration for defining the types of Ecore_IMF Input Hints.

Since (EFL) :

1.12

Enumerator:

ECORE_IMF_INPUT_HINT_NONE	No active hints Since (EFL) : 1.12
ECORE_IMF_INPUT_HINT_AUTO_COMPLETE	Suggest word auto completion Since (EFL) : 1.12
ECORE_IMF_INPUT_HINT_SENSITIVE_DATA	Typed text should not be stored. Since (EFL) : 1.12
ECORE_IMF_INPUT_HINT_MULTILINE	Multiline text Since (EFL) : 1.18

Types for Ecore_IMF input mode

Enum containing input panel events.

Enumerator:

ECORE_IMF_INPUT_PANEL_STATE_EVENT	called when the state of the input panel is changed. Since (EFL) : 1.7
ECORE_IMF_INPUT_PANEL_LANGUAGE_EVENT	called when the language of the input panel is changed. Since (EFL) : 1.7
ECORE_IMF_INPUT_PANEL_SHIFT_MODE_EVENT	called when the shift key state of the input panel is changed Since (EFL) : 1.7
ECORE_IMF_INPUT_PANEL_GEOMETRY_EVENT	called when the size of the input panel is changed. Since (EFL) : 1.7
ECORE_IMF_CANDIDATE_PANEL_STATE_EVENT	called when the state of the candidate word panel is changed. Since (EFL) : 1.7
ECORE_IMF_CANDIDATE_PANEL_GEOMETRY_EVENT	called when the size of the candidate word panel is changed. Since (EFL) : 1.7
ECORE_IMF_INPUT_PANEL_KEYBOARD_MODE_EVENT	called when the keyboard mode state of the input panel is changed Since (EFL) : 1.20 Since : 3.0

Enum containing keyboard mode states.

Since :

3.0

Enumerator:

ECORE_IMF_INPUT_PANEL_HW_KEYBOARD_MODE	Since (EFL) : 1.20
ECORE_IMF_INPUT_PANEL_SW_KEYBOARD_MODE	Since (EFL) : 1.20

Input panel (virtual keyboard) language modes.

See also:

ecore_imf_context_input_panel_language_set()

Enumerator:

ECORE_IMF_INPUT_PANEL_LANG_AUTOMATIC	Automatic Since (EFL) : 1.2
ECORE_IMF_INPUT_PANEL_LANG_ALPHABET	Alphabet Since (EFL) : 1.2

Input panel (virtual keyboard) layout types.

See also:

ecore_imf_context_input_panel_layout_set()

Enumerator:

ECORE_IMF_INPUT_PANEL_LAYOUT_NORMAL	Default layout
ECORE_IMF_INPUT_PANEL_LAYOUT_NUMBER	Number layout
ECORE_IMF_INPUT_PANEL_LAYOUT_EMAIL	Email layout
ECORE_IMF_INPUT_PANEL_LAYOUT_URL	URL layout
ECORE_IMF_INPUT_PANEL_LAYOUT_PHONENUMBER	Phone Number layout
ECORE_IMF_INPUT_PANEL_LAYOUT_IP	IP layout
ECORE_IMF_INPUT_PANEL_LAYOUT_MONTH	Month layout
ECORE_IMF_INPUT_PANEL_LAYOUT_NUMBERONLY	Number Only layout
ECORE_IMF_INPUT_PANEL_LAYOUT_INVALID	Never use this
ECORE_IMF_INPUT_PANEL_LAYOUT_HEX	Hexadecimal layout Since (EFL) : 1.2
ECORE_IMF_INPUT_PANEL_LAYOUT_TERMINAL	Command-line terminal layout including ESC, Alt, Ctrl key, so on (no auto-correct, no auto-capitalization) Since (EFL) : 1.2
ECORE_IMF_INPUT_PANEL_LAYOUT_PASSWORD	Like normal, but no auto-correct, no auto-capitalization etc. Since (EFL) : 1.2
ECORE_IMF_INPUT_PANEL_LAYOUT_DATETIME	Date and time layout Since (EFL) : 1.8
ECORE_IMF_INPUT_PANEL_LAYOUT_EMOTICON	Emoticon layout Since (EFL) : 1.10
ECORE_IMF_INPUT_PANEL_LAYOUT_VOICE	Voice layout, but if the IME does not support voice layout, then normal layout will be shown Since (EFL) : 1.19

"Return" Key types on the input panel (virtual keyboard).

See also:

ecore_imf_context_input_panel_return_key_type_set()

Enumerator:

ECORE_IMF_INPUT_PANEL_RETURN_KEY_TYPE_DEFAULT	Default Since (EFL) : 1.2
ECORE_IMF_INPUT_PANEL_RETURN_KEY_TYPE_DONE	Done Since (EFL) : 1.2
ECORE_IMF_INPUT_PANEL_RETURN_KEY_TYPE_GO	Go Since (EFL) : 1.2
ECORE_IMF_INPUT_PANEL_RETURN_KEY_TYPE_JOIN	Join Since (EFL) : 1.2
ECORE_IMF_INPUT_PANEL_RETURN_KEY_TYPE_LOGIN	Login Since (EFL) : 1.2
ECORE_IMF_INPUT_PANEL_RETURN_KEY_TYPE_NEXT	Next Since (EFL) : 1.2
ECORE_IMF_INPUT_PANEL_RETURN_KEY_TYPE_SEARCH	Search or magnifier icon Since (EFL) : 1.2
ECORE_IMF_INPUT_PANEL_RETURN_KEY_TYPE_SEND	Send Since (EFL) : 1.2
ECORE_IMF_INPUT_PANEL_RETURN_KEY_TYPE_SIGNIN	Sign-in Since (EFL) : 1.8

Enum containing input shift mode states.

Enumerator:

ECORE_IMF_INPUT_PANEL_SHIFT_MODE_OFF	Since (EFL) : 1.7
ECORE_IMF_INPUT_PANEL_SHIFT_MODE_ON	Since (EFL) : 1.7

Enum containing input panel state notifications.

Enumerator:

ECORE_IMF_INPUT_PANEL_STATE_SHOW	Notification after the display of the input panel Since (EFL) : 1.7
ECORE_IMF_INPUT_PANEL_STATE_HIDE	Notification prior to the dismissal of the input panel Since (EFL) : 1.7
ECORE_IMF_INPUT_PANEL_STATE_WILL_SHOW	Notification prior to the display of the input panel Since (EFL) : 1.7

Types for Ecore_IMF keyboard locks

Enumerator:

ECORE_IMF_KEYBOARD_LOCK_NONE	No locks are active
ECORE_IMF_KEYBOARD_LOCK_NUM	"Num" lock is active
ECORE_IMF_KEYBOARD_LOCK_CAPS	"Caps" lock is active
ECORE_IMF_KEYBOARD_LOCK_SCROLL	"Scroll" lock is active

Types for Ecore_IMF keyboard modifiers

Enumerator:

ECORE_IMF_KEYBOARD_MODIFIER_NONE	No active modifiers
ECORE_IMF_KEYBOARD_MODIFIER_CTRL	"Control" is pressed
ECORE_IMF_KEYBOARD_MODIFIER_ALT	"Alt" is pressed
ECORE_IMF_KEYBOARD_MODIFIER_SHIFT	"Shift" is pressed
ECORE_IMF_KEYBOARD_MODIFIER_WIN	"Win" (between "Ctrl" and "Alt") is pressed
ECORE_IMF_KEYBOARD_MODIFIER_ALTGR	"AltGr" is pressed Since (EFL) : 1.7

Types for Ecore_IMF mouse flags

Enumerator:

ECORE_IMF_MOUSE_NONE	A single click
ECORE_IMF_MOUSE_DOUBLE_CLICK	A double click
ECORE_IMF_MOUSE_TRIPLE_CLICK	A triple click

Ecore IMF Preedit style types

See also:

ecore_imf_context_preedit_string_with_attributes_get()

Enumerator:

ECORE_IMF_PREEDIT_TYPE_NONE	None style Since (EFL) : 1.1
ECORE_IMF_PREEDIT_TYPE_SUB1	Substring style 1 Since (EFL) : 1.1
ECORE_IMF_PREEDIT_TYPE_SUB2	Substring style 2 Since (EFL) : 1.1
ECORE_IMF_PREEDIT_TYPE_SUB3	Substring style 3 Since (EFL) : 1.1
ECORE_IMF_PREEDIT_TYPE_SUB4	Substring style 4 Since (EFL) : 1.8
ECORE_IMF_PREEDIT_TYPE_SUB5	Substring style 5 Since (EFL) : 1.8
ECORE_IMF_PREEDIT_TYPE_SUB6	Substring style 6 Since (EFL) : 1.8
ECORE_IMF_PREEDIT_TYPE_SUB7	Substring style 7 Since (EFL) : 1.8

Creates a new Input Method Context defined by the given id.

Parameters:

id	The Input Method Context id.

Returns:

A newly allocated Input Method Context; on failure it returns NULL.

Since :

2.3.1

Examples:

ecore_imf_example.c.

Gets the autocapitalization type.

Parameters:

ctx	An Ecore_IMF_Context.

Returns:

The autocapital type being used by ctx.

Since (EFL) :

1.1.0

Since :

2.3.1

Sets the autocapitalization type on the immodule.

Parameters:

ctx	An Ecore_IMF_Context.
autocapital_type	the autocapitalization type.

Note:

Default type is ECORE_IMF_AUTOCAPITAL_TYPE_SENTENCE.

Since (EFL) :

1.1.0

Since :

2.3.1

Gets the list of the available Input Method Context ids by canvas type.

Note that the caller is responsible for freeing the Eina_List when finished with it. There is no need to finish the list strings.

Parameters:

canvas_type

A string containing the canvas type.

Returns:

Return an Eina_List of strings; on failure it returns NULL.

Since :

2.3.1

Gets the list of the available Input Method Context ids.

Note that the caller is responsible for freeing the Eina_List when finished with it. There is no need to finish the list strings.

Returns:

Return an Eina_List of strings; on failure it returns NULL.

Since :

2.3.1

Gets the bidirectionality at the current cursor position.

Since (EFL) :

1.12.0

Parameters:

[in]

ctx

An Ecore_IMF_Context

Returns:

The direction mode

Since :

2.3.1

Sets the bidirectionality at the current cursor position.

Since (EFL) :

1.12.0

Parameters:

[in]	ctx	An Ecore_IMF_Context
[in]	direction	The direction mode

Since :

2.3.1

Examples:

ecore_imf_example.c.

Gets the geometry information of the candidate panel.

Parameters:

ctx	An Ecore_IMF_Context.
x	top-left x co-ordinate of the candidate panel
y	top-left y co-ordinate of the candidate panel
w	width of the candidate panel
h	height of the candidate panel

Since (EFL) :

1.3

Since :

2.3.1

Gets the client canvas of the Input Method Context.

See ecore_imf_context_client_canvas_set for more details.

Parameters:

ctx	An Ecore_IMF_Context.

Returns:

Return the client canvas.

Since (EFL) :

1.1.0

Since :

2.3.1

Sets the client canvas for the Input Method Context; this is the canvas in which the input appears. The canvas type can be determined by using the context canvas type. Actually only canvas with type "evas" (Evas *) is supported. This canvas may be used in order to correctly position status windows, and may also be used for purposes internal to the Input Method Context.

Parameters:

ctx	An Ecore_IMF_Context.
canvas	The client canvas. This may be NULL to indicate that the previous client canvas no longer exists.

Since :

2.3.1

Examples:

ecore_imf_example.c.

Gets the client window of the Input Method Context.

See ecore_imf_context_client_window_set for more details.

Parameters:

ctx	An Ecore_IMF_Context.

Returns:

Return the client window.

Since (EFL) :

1.1.0

Since :

2.3.1

Sets the client window for the Input Method Context; this is the Ecore_X_Window when using X11, Ecore_Win32_Window when using Win32, etc. This window is used in order to correctly position status windows, and may also be used for purposes internal to the Input Method Context.

Parameters:

ctx	An Ecore_IMF_Context.
window	The client window. This may be NULL to indicate that the previous client window no longer exists.

Since :

2.3.1

Asks the Input Method Context to hide the control panel of using Input Method.

Parameters:

ctx	An Ecore_IMF_Context.

Since (EFL) :

1.1.0

Since :

2.3.1

Asks the Input Method Context to show the control panel of using Input Method.

Parameters:

ctx	An Ecore_IMF_Context.

Since (EFL) :

1.1.0

Since :

2.3.1

Notifies the Input Method Context that a change in the cursor location has been made. The location is relative to the canvas. The cursor location can be used to determine the position of candidate word window in the immodule.

Parameters:

ctx	An Ecore_IMF_Context.
x	cursor x position.
y	cursor y position.
w	cursor width.
h	cursor height.

Since (EFL) :

1.1.0

Since :

2.3.1

Examples:

ecore_imf_example.c.

Notifies the Input Method Context that a change in the cursor position has been made.

This function should be called when cursor position is changed or mouse up event is generated. Some input methods that do a heavy job using this event can give a critical performance latency problem. For better typing performance, we suggest that the cursor position change events need to be occurred only if the cursor position is on a confirmed status not on moving status.

Parameters:

ctx	An Ecore_IMF_Context.
cursor_pos	New cursor position in characters.

Since :

2.3.1

Examples:

ecore_imf_example.c.

Gets the id of the default Input Method Context corresponding to a canvas type. The id may be used to create a new instance of an Input Method Context object.

Parameters:

canvas_type

A string containing the canvas type.

Returns:

Return a string containing the id of the default Input Method Context; on failure it returns NULL.

Since :

2.3.1

Gets the id of the default Input Method Context. The id may to used to create a new instance of an Input Method Context object.

Returns:

Return a string containing the id of the default Input Method Context; on failure it returns NULL.

Since :

2.3.1

Examples:

ecore_imf_example.c.

Deletes the given Input Method Context and free its memory.

Parameters:

ctx	An Ecore_IMF_Context.

Since :

2.3.1

Examples:

ecore_imf_example.c.

Adds (registers) a callback function to a given context event.

This function adds a function callback to the context ctx when the event of type type occurs on it. The function pointer is func.

The event type type to trigger the function may be one of ECORE_IMF_CALLBACK_PREEDIT_START, ECORE_IMF_CALLBACK_PREEDIT_END, ECORE_IMF_CALLBACK_PREEDIT_CHANGED, ECORE_IMF_CALLBACK_COMMIT and ECORE_IMF_CALLBACK_DELETE_SURROUNDING.

Parameters:

ctx	Ecore_IMF_Context to attach a callback to.
type	The type of event that will trigger the callback
func	The (callback) function to be called when the event is triggered
data	The data pointer to be passed to func

Since (EFL) :

1.2.0

Example

 static void
 _imf_event_commit_cb(void *data, Ecore_IMF_Context *ctx, void *event_info)
 {
    char *commit_str = event_info;
    // something to do
 }

 ecore_imf_context_event_callback_add(en->imf_context, ECORE_IMF_CALLBACK_COMMIT, _imf_event_commit_cb, data);

Since :

2.3.1

Examples:

ecore_imf_example.c.

Deletes (unregisters) a callback function registered to a given context event.

This function removes a function callback from the context ctx when the event of type type occurs on it. The function pointer is func.

See also:

ecore_imf_context_event_callback_add() for more details

Parameters:

ctx	Ecore_IMF_Context to remove a callback from.
type	The type of event that was triggering the callback
func	The (callback) function that was to be called when the event was triggered

Returns:

the data pointer

Since (EFL) :

1.2.0

Since :

2.3.1

Examples:

ecore_imf_example.c.

Allows an Ecore Input Context to internally handle an event. If this function returns EINA_TRUE, then no further processing should be done for this event.

Input methods must be able to accept all types of events (simply returning EINA_FALSE if the event was not handled), but there is no obligation of any events to be submitted to this function.

Parameters:

ctx	An Ecore_IMF_Context.
type	The type of event defined by Ecore_IMF_Event_Type.
event	The event itself.

Returns:

EINA_TRUE if the event was handled; otherwise EINA_FALSE.

Example

 static void
 _key_down_cb(void *data, Evas *e, Evas_Object *obj, void *event_info)
 {
    Evas_Event_Key_Down *ev = event_info;
    if (!ev->key) return;

    if (imf_context)
      {
         Ecore_IMF_Event_Key_Down ecore_ev;
         ecore_imf_evas_event_key_down_wrap(ev, &ecore_ev);
         if (ecore_imf_context_filter_event(imf_context,
                                            ECORE_IMF_EVENT_KEY_DOWN,
                                            (Ecore_IMF_Event *)&ecore_ev))
           return;
      }
 }

 evas_object_event_callback_add(obj, EVAS_CALLBACK_KEY_DOWN, _key_down_cb, data);

Since :

2.3.1

Examples:

ecore_imf_example.c.

Notifies the Input Method Context that the widget to which its correspond has gained focus.

Parameters:

ctx	An Ecore_IMF_Context.

Example

 static void
 _focus_in_cb(void *data, Evas_Object *o, const char *emission, const char *source)
 {
    Ecore_IMF_Context *imf_context = data;
    ecore_imf_context_focus_in(imf_context);
 }

 evas_object_event_callback_add(obj, EVAS_CALLBACK_FOCUS_IN, _focus_in_cb, imf_context);

Since :

2.3.1

Examples:

ecore_imf_example.c.

Notifies the Input Method Context that the widget to which its correspond has lost focus.

Parameters:

ctx	An Ecore_IMF_Context.

Example

 static void
 _focus_out_cb(void *data, Evas_Object *o, const char *emission, const char *source)
 {
    Ecore_IMF_Context *imf_context = data;
    ecore_imf_context_reset(imf_context);
    ecore_imf_context_focus_out(imf_context);
 }

 evas_object_event_callback_add(obj, EVAS_CALLBACK_FOCUS_OUT, _focus_out_cb, ed);

Since :

2.3.1

Examples:

ecore_imf_example.c.

Asks the Input Method Context to hide itself.

Parameters:

ctx	An Ecore_IMF_Context.

Since :

2.3.1

Retrieves the info for the Input Method Context with id.

Parameters:

id	The Input Method Context id to query for.

Returns:

Return a Ecore_IMF_Context_Info for the Input Method Context with id; on failure it returns NULL.

Example

 const char *ctx_id;
 const Ecore_IMF_Context_Info *ctx_info;
 Ecore_IMF_Context *imf_context;
 ctx_id = ecore_imf_context_default_id_get();
 if (ctx_id)
   {
      ctx_info = ecore_imf_context_info_by_id_get(ctx_id);
      if (!ctx_info->canvas_type ||
          strcmp(ctx_info->canvas_type, "evas") == 0)
        {
           imf_context = ecore_imf_context_add(ctx_id);
        }
      else
        {
           ctx_id = ecore_imf_context_default_id_by_canvas_type_get("evas");
           if (ctx_id)
             {
                imf_context = ecore_imf_context_add(ctx_id);
             }
        }
   }

Since :

2.3.1

Retrieves the info for the given Input Method Context.

Parameters:

ctx	An Ecore_IMF_Context.

Returns:

Return a Ecore_IMF_Context_Info for the given Input Method Context; on failure it returns NULL.

Since :

2.3.1

Gets the value of input hint.

Parameters:

ctx	An Ecore_IMF_Context

Returns:

The value of input hint

Since (EFL) :

1.12

Since :

2.3.1

Sets the input hint which allows input methods to fine-tune their behavior.

Parameters:

ctx	An Ecore_IMF_Context
hints	Input hint

Note:

The default input hint is ECORE_IMF_INPUT_HINT_AUTO_COMPLETE.

Since (EFL) :

1.12

Since :

2.3.1

Gets the input mode being used by the Ecore Input Context.

See ecore_imf_context_input_mode_set for more details.

Parameters:

ctx	An Ecore_IMF_Context.

Returns:

The input mode being used by ctx.

Since :

2.3.1

Sets the input mode used by the Ecore Input Context.

The input mode can be one of the input modes defined in Ecore_IMF_Input_Mode. The default input mode is ECORE_IMF_INPUT_MODE_FULL.

Parameters:

ctx	An Ecore_IMF_Context.
input_mode	The input mode to be used by ctx.

Since :

2.3.1

Gets the caps lock mode on the input panel.

Parameters:

ctx	An Ecore_IMF_Context.

Returns:

EINA_TRUE if the caps lock is turned on.

Since (EFL) :

1.2.0

Since :

2.3.1

Sets the caps lock mode on the input panel.

Parameters:

ctx	An Ecore_IMF_Context.
mode	Turn on caps lock on the input panel if EINA_TRUE.

Since (EFL) :

1.2.0

Since :

2.3.1

Gets whether the Input Method Context requests to show the input panel automatically.

Parameters:

ctx	An Ecore_IMF_Context.

Returns:

Return the attribute to show the input panel automatically

Since (EFL) :

1.1.0

Since :

2.3.1

Sets whether the Input Method Context should request to show the input panel automatically when the widget has focus.

Parameters:

ctx	An Ecore_IMF_Context.
enabled	If true, the input panel will be shown when the widget is clicked or has focus.

Since (EFL) :

1.1.0

Since :

2.3.1

Registers a callback function which will be called if there is change in input panel state,language,mode etc. In order to deregister the callback function Use ecore_imf_context_input_panel_event_callback_del.

Parameters:

ctx	An Ecore_IMF_Context
type	event type
func	the callback function
data	application-input panel specific data.

Since (EFL) :

1.3

Since :

2.3.1

Calls a given input panel callback on the context ctx.

Parameters:

ctx	Ecore_IMF_Context.
type	The type of event that will trigger the callback
value	the event value

Since (EFL) :

1.8.0

Since :

2.3.1

Deletes all input panel callback on the context ctx.

Deletes all input panel callback to be registered by ecore_imf_context_input_panel_event_callback_add()

Parameters:

ctx	Ecore_IMF_Context.

Since (EFL) :

1.8.0

Since :

2.3.1

Unregisters a callback function which will be called if there is change in input panel state, language, mode etc.

Parameters:

ctx	An Ecore_IMF_Context.
type	An Ecore_IMF_Input_Panel_Event.
func	the callback function

Since (EFL) :

1.3

Since :

2.3.1

Gets the position of the current active input panel.

Parameters:

ctx	An Ecore_IMF_Context.
x	top-left x co-ordinate of the input panel
y	top-left y co-ordinate of the input panel
w	width of the input panel
h	height of the input panel

Since (EFL) :

1.3

Since :

2.3.1

Asks the Input Method Context to hide the input panel.

Parameters:

ctx	An Ecore_IMF_Context.

Since (EFL) :

1.1.0

Since :

2.3.1

Gets the specific data of the current active input panel.

Parameters:

ctx	An Ecore_IMF_Context.
data	The specific data to be got from the input panel
len	The length of data

Since (EFL) :

1.2.0

Since :

2.3.1

Sets the input panel-specific data to deliver to the input panel. This API is used by applications to deliver specific data to the input panel. The data format MUST be negotiated by both application and the input panel. The size and format of data are defined by the input panel.

Parameters:

ctx	An Ecore_IMF_Context.
data	The specific data to be set to the input panel.
len	the length of data, in bytes, to send to the input panel

Since (EFL) :

1.2.0

Since :

2.3.1

Gets the language of the input panel.

See ecore_imf_context_input_panel_language_set for more details.

Parameters:

ctx	An Ecore_IMF_Context.

Returns:

Ecore_IMF_Input_Panel_Lang

Since (EFL) :

1.1.0

Since :

2.3.1

Gets the current language locale of the input panel.

ex) fr_FR

Parameters:

ctx	An Ecore_IMF_Context.
lang	Location to store the retrieved language string. The string retrieved must be freed with free().

Since (EFL) :

1.3

Since :

2.3.1

Sets the language of the input panel. This API can be used when you want to show the English keyboard.

Parameters:

ctx	An Ecore_IMF_Context.
lang	the language to be set to the input panel.

Since (EFL) :

1.1.0

Since :

2.3.1

Gets the layout of the current active input panel.

Parameters:

ctx	An Ecore_IMF_Context.

Returns:

layout see Ecore_IMF_Input_Panel_Layout

Since (EFL) :

1.1.0

Since :

2.3.1

Sets the layout of the input panel.

Parameters:

ctx	An Ecore_IMF_Context.
layout	see Ecore_IMF_Input_Panel_Layout

Note:

Default layout type is ECORE_IMF_INPUT_PANEL_LAYOUT_NORMAL.

Since (EFL) :

1.1.0

Since :

2.3.1

Gets the layout variation of the current active input panel.

Parameters:

ctx	An Ecore_IMF_Context.

Returns:

the layout variation

Since (EFL) :

1.8.0

Since :

2.3.1

Sets the layout variation of the current active input panel.

Parameters:

ctx	An Ecore_IMF_Context.
variation	the layout variation

Note:

Default layout variation type is NORMAL.

Since (EFL) :

1.8.0

Since :

2.3.1

Sets the x,y coordinates of the input panel. This API can be used in floating mode.

Since (EFL) :

1.21.0

Parameters:

[in]	ctx	An Ecore_IMF_Context
	x	top-left x coordinate of the input panel
	y	top-left y coordinate of the input panel

Since :

4.0

Gets whether the return key on the input panel should be disabled or not.

Parameters:

ctx	An Ecore_IMF_Context.

Returns:

EINA_TRUE if it should be disabled.

Since (EFL) :

1.2.0

Since :

2.3.1

Sets the return key on the input panel to be disabled.

Parameters:

ctx	An Ecore_IMF_Context.
disabled	The state

Since (EFL) :

1.2.0

Since :

2.3.1

Gets the "return" key type.

See also:

ecore_imf_context_input_panel_return_key_type_set() for more details

Parameters:

ctx	An Ecore_IMF_Context.

Returns:

The type of "return" key on the input panel

Since (EFL) :

1.2.0

Since :

2.3.1

Sets the "return" key type. This type is used to set string or icon on the "return" key of the input panel.

An input panel displays the string or icon associated with this type.
Regardless of return key type, return key event will be generated when pressing return key.

Parameters:

ctx	An Ecore_IMF_Context.
return_key_type	The type of "return" key on the input panel

Note:

Default type is ECORE_IMF_INPUT_PANEL_RETURN_KEY_TYPE_DEFAULT.

Since (EFL) :

1.2.0

Since :

2.3.1

Asks the Input Method Context to show the input panel (virtual keyboard).

Parameters:

ctx	An Ecore_IMF_Context.

Since (EFL) :

1.1.0

Since :

2.3.1

Gets whether the Input Method Context should request to show the input panel in case of only an user's explicit Mouse Up event.

Parameters:

ctx	An Ecore_IMF_Context.

Returns:

EINA_TRUE if the input panel will be shown in case of only Mouse up event.

Since (EFL) :

1.8.0

Since :

2.3.1

Sets whether the Input Method Context should request to show the input panel in case of only an user's explicit Mouse Up event. It doesn't request to show the input panel even though the Input Method Context has focus.

Parameters:

ctx	An Ecore_IMF_Context.
ondemand	If true, the input panel will be shown in case of only Mouse up event. (Focus event will be ignored.)

Since (EFL) :

1.8.0

Since :

2.3.1

Gets state of current active input panel.

Parameters:

ctx	An Ecore_IMF_Context.

Returns:

The state of input panel.

Since (EFL) :

1.3

Since :

2.3.1

Get the keyboard mode on the input panel.

Since (EFL) :

1.20.0

Parameters:

[in]

ctx

An Ecore_IMF_Context

Returns:

the keyboard mode

Since :

4.0

Sets the allowed MIME type to deliver to the input panel.

Since (EFL) :

1.20.0

Parameters:

[in]	ctx	An Ecore_IMF_Context
[in]	mime_type	The allowed MIME type in entry

Example

 const char *mime_type = "text/plain,image/png,application/pdf";
 ecore_imf_context_mime_type_accept_set(imf_context, mime_type);

Since :

4.0

Gets whether the IM context should allow to use the text prediction.

Parameters:

ctx	An Ecore_IMF_Context.

Returns:

EINA_TRUE if it allows to use the text prediction, otherwise EINA_FALSE.

Since (EFL) :

1.1.0

Since :

2.3.1

Sets whether the IM context should allow to use the text prediction. If prediction is EINA_FALSE (default is EINA_TRUE), then the IM context will not display the text prediction window.

Parameters:

ctx	An Ecore_IMF_Context.
prediction	Whether the IM context should allow to use the text prediction.

Note:

Default value is EINA_TRUE.

Since (EFL) :

1.1.0

Since :

2.3.1

Set the prediction hint string to deliver to the input panel.

This API can be used when you want to set prediction hint to use an intelligent reply suggestion service. An intelligent reply suggestion service generates reply candidates for given prediction hint. Example prediction hint: How are you? -> result: I'm fine, Not bad, I'm all right.

Since (EFL) :

1.20.0

Parameters:

[in]	ctx	An Ecore_IMF_Context
[in]	prediction_hint	The prediction hint string.

Since :

4.0

Retrieves the current preedit string and cursor position for the Input Method Context.

Parameters:

ctx	An Ecore_IMF_Context.
str	Location to store the retrieved string. The string retrieved must be freed with free().
cursor_pos	Location to store position of cursor (in characters) within the preedit string.

Since :

2.3.1

Retrieves the current preedit string, attributes and cursor position for the Input Method Context.

Parameters:

ctx	An Ecore_IMF_Context.
str	Location to store the retrieved string. The string retrieved must be freed with free().
attrs	An Eina_List of attributes
cursor_pos	Location to store position of cursor (in characters) within the preedit string.

Example

 char *preedit_string;
 int cursor_pos;
 Eina_List *attrs = NULL, *l = NULL;
 Ecore_IMF_Preedit_Attr *attr;

 ecore_imf_context_preedit_string_with_attributes_get(imf_context,
                                                      &preedit_string,
                                                      &attrs, &cursor_pos);
 if (!preedit_string) return;

  if (strlen(preedit_string) > 0)
    {
       if (attrs)
         {
            EINA_LIST_FOREACH(attrs, l, attr)
              {
                 if (attr->preedit_type == ECORE_IMF_PREEDIT_TYPE_SUB1)
                   {
                      // Something to do
                   }
                 else if (attr->preedit_type == ECORE_IMF_PREEDIT_TYPE_SUB2)
                   {
                      // Something to do
                   }
                 else if (attr->preedit_type == ECORE_IMF_PREEDIT_TYPE_SUB3)
                   {
                      // Something to do
                   }
              }
         }
    }

 // delete attribute list
 EINA_LIST_FREE(attrs, attr) free(attr);

 free(preedit_string);

Since (EFL) :

1.1.0

Since :

2.3.1

Examples:

ecore_imf_example.c.

Notifies the Input Method Context that a change such as a change in cursor position has been made. This will typically cause the Input Method Context to clear the preedit state or commit the preedit string.

The operation of ecore_imf_context_reset() depends on the specific characteristics of each language. For example, the preedit string is cleared in the Chinese and Japanese Input Method Engine. However, The preedit string is committed and then cleared in the Korean Input Method Engine.

This function should be called in case of the focus-out and mouse down event callback function. In addition, it should be called before inserting some text.

Parameters:

ctx	An Ecore_IMF_Context.

Example

 static void
 _focus_out_cb(void *data, Evas_Object *o, const char *emission, const char *source)
 {
    Ecore_IMF_Context *imf_context = data;
    ecore_imf_context_reset(imf_context);
    ecore_imf_context_focus_out(imf_context);
 }

 evas_object_event_callback_add(obj, EVAS_CALLBACK_FOCUS_OUT, _focus_out_cb, imf_context);

Since :

2.3.1

Examples:

ecore_imf_example.c.

Sets the callback to be used on selection_get request.

This callback will be called when the Input Method Context module requests the selection context.

Parameters:

ctx	An Ecore_IMF_Context.
func	The callback to be called.
data	The data pointer to be passed to func

Since (EFL) :

1.9.0

Since :

2.3.1

Sets the callback to be used on surrounding_get request.

This callback will be called when the Input Method Context module requests the surrounding context. Input methods typically want context in order to constrain input text based on existing text; this is important for languages such as Thai where only some sequences of characters are allowed.

Parameters:

ctx	An Ecore_IMF_Context.
func	The callback to be called.
data	The data pointer to be passed to func

Since :

2.3.1

Examples:

ecore_imf_example.c.

Asks the Input Method Context to show itself.

Parameters:

ctx	An Ecore_IMF_Context.

Since :

2.3.1

Sets whether the IM context should use the preedit string to display feedback. If use_preedit is EINA_FALSE (default is EINA_TRUE), then the IM context may use some other method to display feedback, such as displaying it in a child of the root window.

Parameters:

ctx	An Ecore_IMF_Context.
use_preedit	Whether the IM context should use the preedit string.

Since :

2.3.1