Value for IME_ATTR_FONTSTYLE. Draw text in highlighted color.

Since :

3.0

Value for IME_ATTR_FONTSTYLE. Draw text in reversal color.

Since :

3.0

Value for IME_ATTR_FONTSTYLE. Draw a line under the text.

Since :

3.0

Called when Accessibility in Settings application is on or off.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Parameters:

[in]	state	Accessibility option state
[in]	user_data	User data to be passed from the callback registration function

Precondition:

The callback can be registered using ime_event_set_accessibility_state_changed_cb() function.

See also:

ime_event_set_accessibility_state_changed_cb()

Handle of an associated text input UI control's input context.

This is one of parameters of ime_show_cb() callback function. IME application should configure its input panel with this structure information.

Since :

3.0

See also:

ime_context_get_layout()

ime_context_get_layout_variation()

ime_context_get_cursor_position()

ime_context_get_autocapital_type()

ime_context_get_return_key_type()

ime_context_get_return_key_state()

ime_context_get_prediction_mode()

ime_context_get_password_mode()

ime_context_get_input_hint()

ime_context_get_bidi_direction()

ime_context_get_language()

Called when the input panel is created.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

This callback function is mandatory and must be registered using ime_run(). The ime_get_main_window() can be used to get the created input panel window.

Parameters:

[in]

user_data

User data to be passed from the callback registration function

Precondition:

The ime_run() function calls this callback function.

See also:

ime_run()

ime_set_size()

ime_get_main_window()

Called when the position of the cursor in an associated text input UI control changes.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Parameters:

[in]	cursor_pos	The cursor position
[in]	user_data	User data to be passed from the callback registration function

Precondition:

The callback can be registered using ime_event_set_cursor_position_updated_cb() function.

See also:

ime_event_set_cursor_position_updated_cb()

Handle of the device information of the key event.

This is one of parameters of ime_process_key_event_cb() callback function. IME application may distinguish the key event by using this if necessary.

Since :

3.0

See also:

ime_process_key_event_cb()

ime_device_info_get_name()

ime_device_info_get_class()

ime_device_info_get_subclass()

Called when the system display language is changed.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Parameters:

[in]	language	The language code
[in]	user_data	User data to be passed from the callback registration function

Precondition:

The callback can be registered using ime_event_set_display_language_changed_cb() function.

See also:

ime_event_set_display_language_changed_cb()

Called when an associated text input UI control has focus.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Parameters:

[in]	context_id	The input context identification value of an associated text input UI control
[in]	user_data	User data to be passed from the callback registration function

Precondition:

The callback can be registered using ime_event_set_focus_in_cb() function.

See also:

ime_event_set_focus_in_cb()

Called when an associated text input UI control loses focus.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Parameters:

[in]	context_id	The input context identification value of an associated text input UI control
[in]	user_data	User data to be passed from the callback registration function

Precondition:

The callback can be registered using ime_event_set_focus_out_cb() function.

See also:

ime_event_set_focus_out_cb()

Called when an associated text input UI control requests the position and size from the input panel.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

x, y, w, and h should not be released.

Parameters:

[in]	user_data	User data to be passed from the callback registration function
[out]	x	The x position in screen
[out]	y	The y position in screen
[out]	w	The window width
[out]	h	The window height

Precondition:

The callback can be registered using ime_event_set_geometry_requested_cb() function.

See also:

ime_event_set_geometry_requested_cb()

Called when an associated text input UI control requests the input panel to hide itself.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

This callback function is mandatory and must be registered using ime_run(). The ime_get_main_window() can be used to get the created input panel window.

Parameters:

[in]	context_id	The input context identification value of an associated text input UI control
[in]	user_data	User data to be passed from the callback registration function

See also:

ime_run()

ime_get_main_window()

Called when an associated text input UI control requests the application specific data from the input panel.

This function is used by the applications to request the specific data from the input panel. The data format MUST be negotiated by both application and input panel.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

The allocated data and data_length will be released internally.

Parameters:

[in]	user_data	User data to be passed from the callback registration function
[out]	data	Input panel's data to be set to the application
[out]	data_length	The length of data, in bytes, to send to the application

Precondition:

The callback can be registered using ime_event_set_imdata_requested_cb() function.

See also:

ime_event_set_imdata_requested_cb()

Called to set the application specific data to deliver to the input panel.

This function is used by the applications to deliver the specific data to the input panel. The data format MUST be negotiated by both application and input panel.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

data should not be released.

Parameters:

[in]	data	The specific data to be set to the input panel
[in]	data_length	The length of data, in bytes, to send to the input panel
[in]	user_data	User data to be passed from the callback registration function

Precondition:

The callback can be registered using ime_event_set_imdata_set_cb() function.

See also:

ime_event_set_imdata_set_cb()

Called to reset the input context of an associated text input UI control.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Parameters:

[in]

user_data

User data to be passed from the callback registration function

Precondition:

The callback can be registered using ime_event_set_input_context_reset_cb() function.

See also:

ime_event_set_input_context_reset_cb()

The handle to retrieve unconventional input device specific event data.

Since :

3.0

See also:

ime_event_set_process_input_device_event_cb()

Called when an associated text input UI control requests the language from the input panel.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

The allocated lang_code will be released internally.

Parameters:

[in]	user_data	User data to be passed from the callback registration function
[out]	lang_code	Input panel's current input language code (e.g., "en_US")

Precondition:

The callback can be registered using ime_event_set_language_requested_cb() function.

See also:

ime_event_set_language_requested_cb()

Called to set the preferred language to the input panel.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

language information is already set to the input panel when it is shown through ime_context_h. This callback function will be only called when the client application changes the edit field's language attribute after the input panel is shown.

Parameters:

[in]	language	The preferred language that the client application wants
[in]	user_data	User data to be passed from the callback registration function

Precondition:

The callback can be registered using ime_event_set_language_set_cb() function.

See also:

ime_event_set_language_set_cb()

Called when an associated text input UI control requests the input panel to set its layout.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

layout information is already set to the input panel when it is shown through ime_context_h. This callback function will be only called when the client application changes the edit field's layout attribute after the input panel is shown.

Parameters:

[in]	layout	The input panel layout
[in]	user_data	User data to be passed from the callback registration function

Precondition:

The callback can be registered using ime_event_set_layout_set_cb() function.

See also:

ime_event_set_layout_set_cb()

Called when an associated text input UI control requests the text entry to set the MIME type.

Since :

4.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

mime_type is valid only in the callback. To use outside the callback, make a copy. This function is used by the applications to deliver the MIME type to the input panel.

Parameters:

[in]	mime_type	The MIME type to be set to the input panel
[in]	user_data	User data to be passed to the callback function

Precondition:

The callback can be registered using ime_event_set_mime_type_set_request_cb() function.

See also:

ime_event_set_mime_type_set_request_cb()

Called to create the option window.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

if Input panel requests to open the option window, type will be IME_OPTION_WINDOW_TYPE_KEYBOARD. And if Settings application requests to open it, type will be IME_OPTION_WINDOW_TYPE_SETTING_APPLICATION. The window should not be released. The window can be used until ime_option_window_destroyed_cb() will be called.

Parameters:

[in]	window	The created window object
[in]	type	The type of option window
[in]	user_data	User data to be passed from the callback registration function

Precondition:

The callback can be registered using ime_event_set_option_window_created_cb() function. The ime_create_option_window() calls this callback function or Settings application can call this callback function.

See also:

ime_event_set_option_window_created_cb()

ime_create_option_window()

Called to destroy the option window.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

The window should be released using evas_object_del().

Parameters:

[in]	window	The window object to destroy
[in]	user_data	User data to be passed to the callback function

Precondition:

The callback can be registered using ime_event_set_option_window_destroyed_cb() function. ime_destroy_option_window() calls this callback function.

See also:

ime_event_set_option_window_destroyed_cb()

Called to set key-value pairs of predicting messages to deliver to the input panel.

Since :

5.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

key and value is valid only in the callback. To use outside the callback, make a copy. This function is used by applications to deliver predicted hint messages to the input panel.

Parameters:

[in]	key	The prediction hint key to be set to the input panel
[in]	value	The prediction hint value to be set to the input panel
[in]	user_data	User data to be passed to the callback function

Precondition:

The callback can be registered using ime_event_set_prediction_hint_data_set_cb() function.

See also:

ime_event_set_prediction_hint_data_set_cb()

Called to set the prediction hint string to deliver to the input panel.

Since :

4.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

prediction_hint is valid only in the callback. To use outside the callback, make a copy. This function is used by the applications to deliver the prediction hint message to the input panel.

Parameters:

[in]	prediction_hint	The prediction hint to be set to the input panel
[in]	user_data	User data to be passed to the callback function

Precondition:

The callback can be registered using ime_event_set_prediction_hint_set_cb() function.

See also:

ime_event_set_prediction_hint_set_cb()

Called when the input event is received from an unconventional input device that does not generate key events.

This function processes the input event before an associated text input UI control does.

Since :

3.0

Remarks:

device_type contains the information what kind of unconventional input device generated the given event, and the handle device_event is used for obtaining device-specific input device event data. device_event should not be released.

Parameters:

[in]	device_type	The unconventional input device type
[in]	device_event	The handle for device_type specific input device event
[in]	user_data	User data to be passed to the callback function

Precondition:

The callback can be registered using ime_event_set_input_device_event_cb() function.

See also:

ime_event_set_process_input_device_event_cb()

Called when a key event is received from external devices or ime_send_key_event().

This function processes the key event before an associated text input UI control does.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

If the key event is from the external device, dev_info will have its name, class and subclass information. dev_info should not be released by the application. The platform manages the handle; the handle is released when ime_process_key_event_cb() exits.

Parameters:

[in]	key_code	The key code to be sent
[in]	key_mask	The modifier key mask
[in]	dev_info	The device information handle
[in]	user_data	User data to be passed from the callback registration function

Returns:

true if the event was processed, otherwise the event was not processed and was forwarded to the client application.

Precondition:

The callback should be registered using ime_event_set_process_key_event_cb() function.

See also:

ime_event_set_process_key_event_cb()

ime_device_info_get_name()

ime_device_info_get_class()

ime_device_info_get_subclass()

ime_send_key_event()

ime_commit_string()

ime_show_preedit_string()

ime_hide_preedit_string()

ime_update_preedit_string()

Called when a key event is received from external devices or ime_send_key_event().

This function processes a key event with a keycode before an associated UI control for the text input deals with the key event.

Since :

5.5

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

If the key event is from the external device, dev_info will have its name, class and subclass information. dev_info should not be released by the application. The platform manages the handle; the handle is released when ime_process_key_event_with_keycode_cb() exits.

Parameters:

[in]	key_code	The X11 key code to be sent
[in]	key_sym	The key symbol to be sent
[in]	key_mask	The modifier key mask
[in]	dev_info	The device information handle
[in]	user_data	User data to be passed from the callback registration function

Returns:

true if the event was processed, otherwise false. When false returns, the event was not processed and was forwarded to the client application.

Precondition:

The callback should be registered using ime_event_set_process_key_event_with_keycode_cb() function.

See also:

ime_event_set_process_key_event_with_keycode_cb()

ime_device_info_get_name()

ime_device_info_get_class()

ime_device_info_get_subclass()

ime_send_key_event()

ime_commit_string()

ime_show_preedit_string()

ime_hide_preedit_string()

ime_update_preedit_string()

Called when an associated text input UI control requests the input panel to enable or disable the Return key state.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

disabled information is already set to the input panel when it is shown through ime_context_h. This callback function will be only called when the client application changes the edit field's Return key disable attribute after the input panel is shown.

Parameters:

[in]	disabled	The Boolean state to disable Return key. The Return key is enabled by default
[in]	user_data	User data to be passed from the callback registration function

Precondition:

The callback can be registered using ime_event_set_return_key_state_set_cb() function.

See also:

ime_event_set_return_key_state_set_cb()

Called when an associated text input UI control requests the input panel to set the Return key label. The input panel can show text or image on the Return button according to the Return key action.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

type information is already set to the input panel when it is shown through ime_context_h. This callback function will be only called when the client application changes the edit field's Return key type attribute after the input panel is shown.

Parameters:

[in]	type	The type of Return key on the input panel
[in]	user_data	User data to be passed from the callback registration function

Precondition:

The callback can be registered using ime_event_set_return_key_type_set_cb() function.

See also:

ime_event_set_return_key_type_set_cb()

Called when the device is rotated.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Parameters:

[in]	degree	The rotation degree
[in]	user_data	User data to be passed from the callback registration function

Precondition:

The callback can be registered using ime_event_set_rotation_degree_changed_cb() function.

See also:

ime_event_set_rotation_degree_changed_cb()

Called when an associated text input UI control requests the input panel to show itself.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

This callback function is mandatory and must be registered using ime_run(). IME application should configure its input panel with ime_context_h structure information. The ime_get_main_window() can be used to get the created input panel window. context should not be released.

Parameters:

[in]	context_id	The input context identification value of an associated text input UI control
[in]	context	The input context information handle
[in]	user_data	User data to be passed from the callback registration function

See also:

ime_run()

ime_get_main_window()

ime_context_get_layout()

ime_context_get_layout_variation()

ime_context_get_cursor_position()

ime_context_get_autocapital_type()

ime_context_get_return_key_type()

ime_context_get_return_key_state()

ime_context_get_prediction_mode()

ime_context_get_password_mode()

ime_context_get_input_hint()

ime_context_get_bidi_direction()

ime_context_get_language()

Called when an associated text input UI control responds to a request with the surrounding text.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

The ime_request_surrounding_text() must be called to invoke this callback function, asynchronously.

text can be used only in the callback. To use outside, make a copy.

Parameters:

[in]	context_id	The input context identification value of an associated text input UI control
[in]	text	The UTF-8 string requested
[in]	cursor_pos	The cursor position
[in]	user_data	User data to be passed from the callback registration function

Precondition:

The callback can be registered using ime_event_set_surrounding_text_updated_cb() function.

See also:

ime_event_set_surrounding_text_updated_cb()

ime_request_surrounding_text()

Called when the input panel is terminated.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

This callback function is mandatory and must be registered using ime_run(). The ime_get_main_window() can be used to get the created input panel window.

Parameters:

[in]

user_data

User data to be passed from the callback registration function

See also:

ime_run()

ime_get_main_window()

Enumeration of string attribute type.

Since :

3.0

Remarks:

Currently, a font style is available to use.

See also:

ime_preedit_attribute

ime_update_preedit_string()

Enumerator:

IME_ATTR_NONE	No attribute
IME_ATTR_FONTSTYLE	A font style attribute, e.g., underline, etc.

Enumeration for input method function error.

Since :

3.0

Enumerator:

IME_ERROR_NONE	Successful
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_PERMISSION_DENIED	Permission denied
IME_ERROR_NO_CALLBACK_FUNCTION	Necessary callback function is not set
IME_ERROR_NOT_RUNNING	IME main loop is not started yet
IME_ERROR_OPERATION_FAILED	Operation failed
IME_ERROR_OUT_OF_MEMORY	out of memory

Enumeration containing input panel events.

Since :

5.5

See also:

ime_update_input_panel_event()

Enumerator:

IME_EVENT_TYPE_LANGUAGE	The language of the input panel
IME_EVENT_TYPE_SHIFT_MODE	The shift key state of the input panel
IME_EVENT_TYPE_GEOMETRY	The size of the input panel

Enumeration of directions for rotary input device's rotation event.

Since :

3.0

See also:

ime_input_device_rotary_get_direction()

Enumerator:

IME_INPUT_DEVICE_ROTARY_DIRECTION_CLOCKWISE	Rotary is rotated clockwise direction
IME_INPUT_DEVICE_ROTARY_DIRECTION_COUNTER_CLOCKWISE	Rotary is rotated counter clockwise direction

Enumeration of unconventional input devices.

Since :

3.0

See also:

ime_event_set_process_input_device_event_cb()

Enumerator:

IME_INPUT_DEVICE_TYPE_UNKNOWN	Undefined unconventional input device
IME_INPUT_DEVICE_TYPE_ROTARY	A rotary input device such as bezel that can be found on a wearable device

Enumeration for the key codes. If keycode & 0xff000000 == 0x01000000 then this key code is directly encoded 24-bit UCS character. The UCS value is keycode & 0x00ffffff.

Defines the list of keys supported by the system. Note that certain keys may not be available on all devices.

Since :

3.0

Enumerator:

IME_KEY_BackSpace	The backspace key
IME_KEY_Tab	The tab key
IME_KEY_Linefeed	The linefeed key
IME_KEY_Clear	The clear key
IME_KEY_Return	The return key
IME_KEY_Pause	The pause key
IME_KEY_Scroll_Lock	The scroll lock key
IME_KEY_Sys_Req	The sys req key
IME_KEY_Escape	The escape key
IME_KEY_Delete	The delete key
IME_KEY_Home	The home key
IME_KEY_Left	The left directional key
IME_KEY_Up	The up directional key
IME_KEY_Right	The right directional key
IME_KEY_Down	The down directional key
IME_KEY_Prior	The prior, previous key
IME_KEY_Page_Up	The page up key
IME_KEY_Next	The next key
IME_KEY_Page_Down	The page down key
IME_KEY_End	The end key
IME_KEY_Begin	The begin key
IME_KEY_Select	The select key
IME_KEY_Print	The print key
IME_KEY_Execute	The execute, run, do key
IME_KEY_Insert	The insert key
IME_KEY_Undo	The undo key
IME_KEY_Redo	The redo key
IME_KEY_Menu	The menu key
IME_KEY_Find	The find key
IME_KEY_Cancel	The cancel, stop, abort, exit key
IME_KEY_Help	The help key
IME_KEY_Break	The break key
IME_KEY_Mode_switch	The character set switch key
IME_KEY_Num_Lock	The num lock key
IME_KEY_KP_Space	The Numpad space key
IME_KEY_KP_Tab	The Numpad tab key
IME_KEY_KP_Enter	The Numpad enter key
IME_KEY_KP_F1	The Numpad function 1 key
IME_KEY_KP_F2	The Numpad function 2 key
IME_KEY_KP_F3	The Numpad function 3 key
IME_KEY_KP_F4	The Numpad function 4 key
IME_KEY_KP_Home	The Numpad home key
IME_KEY_KP_Left	The Numpad left key
IME_KEY_KP_Up	The Numpad up key
IME_KEY_KP_Right	The Numpad right key
IME_KEY_KP_Down	The Numpad down key
IME_KEY_KP_Prior	The Numpad prior, previous key
IME_KEY_KP_Page_Up	The Numpad page up key
IME_KEY_KP_Next	The Numpad next key
IME_KEY_KP_Page_Down	The Numpad page down key
IME_KEY_KP_End	The Numpad end key
IME_KEY_KP_Begin	The Numpad begin key
IME_KEY_KP_Insert	The Numpad insert key
IME_KEY_KP_Delete	The Numpad delete key
IME_KEY_KP_Equal	The Numpad equal key
IME_KEY_KP_Multiply	The Numpad multiply key
IME_KEY_KP_Add	The Numpad add key
IME_KEY_KP_Separator	The Numpad separator key
IME_KEY_KP_Subtract	The Numpad subtract key
IME_KEY_KP_Decimal	The Numpad decimal key
IME_KEY_KP_Divide	The Numpad divide key
IME_KEY_KP_0	The Numpad 0 key
IME_KEY_KP_1	The Numpad 1 key
IME_KEY_KP_2	The Numpad 2 key
IME_KEY_KP_3	The Numpad 3 key
IME_KEY_KP_4	The Numpad 4 key
IME_KEY_KP_5	The Numpad 5 key
IME_KEY_KP_6	The Numpad 6 key
IME_KEY_KP_7	The Numpad 7 key
IME_KEY_KP_8	The Numpad 8 key
IME_KEY_KP_9	The Numpad 9 key
IME_KEY_F1	The function 1 key
IME_KEY_F2	The function 2 key
IME_KEY_F3	The function 3 key
IME_KEY_F4	The function 4 key
IME_KEY_F5	The function 5 key
IME_KEY_F6	The function 6 key
IME_KEY_F7	The function 7 key
IME_KEY_F8	The function 8 key
IME_KEY_F9	The function 9 key
IME_KEY_F10	The function 10 key
IME_KEY_F11	The function 11 key
IME_KEY_F12	The function 12 key
IME_KEY_F13	The function 13 key
IME_KEY_F14	The function 14 key
IME_KEY_F15	The function 15 key
IME_KEY_F16	The function 16 key
IME_KEY_F17	The function 17 key
IME_KEY_F18	The function 18 key
IME_KEY_F19	The function 19 key
IME_KEY_F20	The function 20 key
IME_KEY_F21	The function 21 key
IME_KEY_F22	The function 22 key
IME_KEY_F23	The function 23 key
IME_KEY_F24	The function 24 key
IME_KEY_F25	The function 25 key
IME_KEY_F26	The function 26 key
IME_KEY_F27	The function 27 key
IME_KEY_F28	The function 28 key
IME_KEY_F29	The function 29 key
IME_KEY_F30	The function 30 key
IME_KEY_F31	The function 31 key
IME_KEY_F32	The function 32 key
IME_KEY_F33	The function 33 key
IME_KEY_F34	The function 34 key
IME_KEY_F35	The function 35 key
IME_KEY_Shift_L	The left shift key
IME_KEY_Shift_R	The right shift key
IME_KEY_Control_L	The left control key
IME_KEY_Control_R	The right control key
IME_KEY_Caps_Lock	The caps lock key
IME_KEY_Shift_Lock	The shift lock key
IME_KEY_Meta_L	The left meta key
IME_KEY_Meta_R	The right meta key
IME_KEY_Alt_L	The left alt key
IME_KEY_Alt_R	The right alt key
IME_KEY_Super_L	The left super key
IME_KEY_Super_R	The right super key
IME_KEY_Hyper_L	The left hyper key
IME_KEY_Hyper_R	The right hyper key
IME_KEY_space	The space key
IME_KEY_exclam	The exclamation key
IME_KEY_quotedbl	The quotedbl key
IME_KEY_numbersign	The number sign key
IME_KEY_dollar	The dollar key
IME_KEY_percent	The percent key
IME_KEY_ampersand	The ampersand key
IME_KEY_apostrophe	The apostrophe key
IME_KEY_parenleft	The parenleft key
IME_KEY_parenright	The parenright key
IME_KEY_asterisk	The asterisk key
IME_KEY_plus	The plus key
IME_KEY_comma	The comma key
IME_KEY_minus	The minus key
IME_KEY_period	The period key
IME_KEY_slash	The slash key
IME_KEY_0	The 0 key
IME_KEY_1	The 1 key
IME_KEY_2	The 2 key
IME_KEY_3	The 3 key
IME_KEY_4	The 4 key
IME_KEY_5	The 5 key
IME_KEY_6	The 6 key
IME_KEY_7	The 7 key
IME_KEY_8	The 8 key
IME_KEY_9	The 9 key
IME_KEY_colon	The colon key
IME_KEY_semicolon	The semicolon key
IME_KEY_less	The less key
IME_KEY_equal	The equal key
IME_KEY_greater	The greater key
IME_KEY_question	The question key
IME_KEY_at	The at key
IME_KEY_A	The A key
IME_KEY_B	The B key
IME_KEY_C	The C key
IME_KEY_D	The D key
IME_KEY_E	The E key
IME_KEY_F	The F key
IME_KEY_G	The G key
IME_KEY_H	The H key
IME_KEY_I	The I key
IME_KEY_J	The J key
IME_KEY_K	The K key
IME_KEY_L	The L key
IME_KEY_M	The M key
IME_KEY_N	The N key
IME_KEY_O	The O key
IME_KEY_P	The P key
IME_KEY_Q	The Q key
IME_KEY_R	The R key
IME_KEY_S	The S key
IME_KEY_T	The T key
IME_KEY_U	The U key
IME_KEY_V	The V key
IME_KEY_W	The W key
IME_KEY_X	The X key
IME_KEY_Y	The Y key
IME_KEY_Z	The Z key
IME_KEY_bracketleft	The left bracket key
IME_KEY_backslash	The backslash key
IME_KEY_bracketright	The right bracket key
IME_KEY_asciicircum	The circumflex key
IME_KEY_underscore	The underscore key
IME_KEY_grave	The grave key
IME_KEY_a	The a key
IME_KEY_b	The b key
IME_KEY_c	The c key
IME_KEY_d	The d key
IME_KEY_e	The e key
IME_KEY_f	The f key
IME_KEY_g	The g key
IME_KEY_h	The h key
IME_KEY_i	The i key
IME_KEY_j	The j key
IME_KEY_k	The k key
IME_KEY_l	The l key
IME_KEY_m	The m key
IME_KEY_n	The n key
IME_KEY_o	The o key
IME_KEY_p	The p key
IME_KEY_q	The q key
IME_KEY_r	The r key
IME_KEY_s	The s key
IME_KEY_t	The t key
IME_KEY_u	The u key
IME_KEY_v	The v key
IME_KEY_w	The w key
IME_KEY_x	The x key
IME_KEY_y	The y key
IME_KEY_z	The z key
IME_KEY_braceleft	The left brace key
IME_KEY_bar	The bar key
IME_KEY_braceright	The right brace key
IME_KEY_asciitilde	The tilde key

Enumeration for the key masks. The key masks indicate which modifier keys is pressed down during the keyboard hit. The special IME_KEY_MASK_RELEASED indicates the key release event.

Since :

3.0

Enumerator:

IME_KEY_MASK_PRESSED	Key press event without modifier key
IME_KEY_MASK_SHIFT	The Shift key is pressed down
IME_KEY_MASK_CAPSLOCK	The CapsLock key is pressed down
IME_KEY_MASK_CONTROL	The Control key is pressed down
IME_KEY_MASK_ALT	The Alt key is pressed down
IME_KEY_MASK_META	The Meta key is pressed down
IME_KEY_MASK_WIN	The Win (between Control and Alt) is pressed down
IME_KEY_MASK_HYPER	The Hyper key is pressed down
IME_KEY_MASK_NUMLOCK	The NumLock key is pressed down
IME_KEY_MASK_RELEASED	Key release event

Enumeration of layout variation.

Since :

3.0

See also:

ime_context_get_layout_variation()

Enumerator:

IME_LAYOUT_NORMAL_VARIATION_NORMAL	The plain normal layout
IME_LAYOUT_NORMAL_VARIATION_FILENAME	Filename layout; symbols such as '/', '*', '\', '|', '<', '>', '?', '"' and ':' should be disabled
IME_LAYOUT_NORMAL_VARIATION_PERSON_NAME	The name of a person
IME_LAYOUT_NUMBERONLY_VARIATION_NORMAL	The plain normal number layout
IME_LAYOUT_NUMBERONLY_VARIATION_SIGNED	The number layout to allow a negative sign
IME_LAYOUT_NUMBERONLY_VARIATION_DECIMAL	The number layout to allow decimal point to provide fractional value
IME_LAYOUT_NUMBERONLY_VARIATION_SIGNED_AND_DECIMAL	The number layout to allow decimal point and negative sign
IME_LAYOUT_PASSWORD_VARIATION_NORMAL	The normal password layout
IME_LAYOUT_PASSWORD_VARIATION_NUMBERONLY	The password layout to allow only number

Enumeration of the option window type.

Since :

3.0

See also:

ime_option_window_created_cb()

Enumerator:

IME_OPTION_WINDOW_TYPE_KEYBOARD	Open from Keyboard
IME_OPTION_WINDOW_TYPE_SETTING_APPLICATION	Open from Setting application

Commits contents such as image to the associated text input UI control.

Since :

4.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Parameters:

[in]	content	The content URI to be sent
[in]	description	The content description
[in]	mime_type	The MIME type received from the ime_mime_type_set_request_cb()

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_NOT_RUNNING	IME main loop is not started yet

See also:

ime_mime_type_set_request_cb()

ime_event_set_mime_type_set_request_cb()

Sends the text to the associated text input UI control.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Parameters:

[in]

str

The UTF-8 string to be committed

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_NOT_RUNNING	IME main loop is not started yet

See also:

ime_show_preedit_string()

ime_hide_preedit_string()

ime_update_preedit_string()

Gets the autocapital type information from the given input context.

Each edit field has various attributes for input panel. This function can be called to get the autocapital type information in ime_show_cb() callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Parameters:

[in]	context	The input context information of an associated text input UI control
[out]	autocapital_type	Autocapital type information

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_NOT_RUNNING	IME main loop is not started yet

Postcondition:

Input panel UI should be drawn or operated by this information accordingly.

See also:

ime_show_cb()

Gets the text bidirectional information from the given input context.

Each edit field has various attributes for input panel. This function can be called to get the bidirectional information in ime_show_cb() callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Parameters:

[in]	context	The input context information of an associated text input UI control
[out]	bidi	Text bidirectional information

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_NOT_RUNNING	IME main loop is not started yet

Postcondition:

Input panel UI should be drawn or operated by this information accordingly.

See also:

ime_show_cb()

Gets the cursor position information from the given input context.

Each edit field has various attributes for input panel. This function can be called to get the cursor position information in ime_show_cb() callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Parameters:

[in]	context	The input context information of an associated text input UI control
[out]	cursor_pos	Cursor position information

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_NOT_RUNNING	IME main loop is not started yet

Postcondition:

Input panel UI should be drawn or operated by this information accordingly.

See also:

ime_show_cb()

ime_cursor_position_updated_cb()

Gets the input hint information from the given input context.

Each edit field has various attributes for input panel. This function can be called to get the input hint information in ime_show_cb() callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

input_hint is a bit-wise value which recommends the input panel provide an auto completion and so on if it is capable of supporting such features.

Parameters:

[in]	context	The input context information of an associated text input UI control
[out]	input_hint	Input hint information

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_NOT_RUNNING	IME main loop is not started yet

Postcondition:

Input panel UI should be drawn or operated by this information accordingly.

See also:

ime_show_cb()

Gets the preferred language information from the given input context.

Each edit field has various attributes for input panel. This function can be called to get the preferred language information in ime_show_cb() callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Parameters:

[in]	context	The input context information of an associated text input UI control
[out]	language	Preferred language information

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_NOT_RUNNING	IME main loop is not started yet

Postcondition:

Input panel UI should be drawn or operated by this information accordingly.

See also:

ime_show_cb()

Gets the layout information from the given input context.

Each edit field has various attributes for input panel. This function can be called to get the layout information in ime_show_cb() callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Parameters:

[in]	context	The input context information of an associated text input UI control
[out]	layout	Layout information

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_NOT_RUNNING	IME main loop is not started yet

Postcondition:

Input panel UI should be drawn or operated by this information accordingly.

See also:

ime_show_cb()

ime_layout_set_cb()

Gets the layout variation information from the given input context.

Each edit field has various attributes for input panel. This function can be called to get the layout variation information in ime_show_cb() callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Parameters:

[in]	context	The input context information of an associated text input UI control
[out]	layout_variation	Layout variation information

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_NOT_RUNNING	IME main loop is not started yet

Postcondition:

Input panel UI should be drawn or operated by this information accordingly.

See also:

ime_show_cb()

ime_layout_variation_e

Gets the password mode information from the given input context.

Each edit field has various attributes for input panel. This function can be called to get the password mode information in ime_show_cb() callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

If password_mode is true, the input panel is advised not to support the predictive text.

Parameters:

[in]	context	The input context information of an associated text input UI control
[out]	password_mode	Password mode information true to indicate that a password being inputted, false to indicate non-password edit field.

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_NOT_RUNNING	IME main loop is not started yet

Postcondition:

Input panel UI should be drawn or operated by this information accordingly.

See also:

ime_show_cb()

Gets the prediction mode information from the given input context.

Each edit field has various attributes for input panel. This function can be called to get the prediction mode information in ime_show_cb() callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Parameters:

[in]	context	The input context information of an associated text input UI control
[out]	prediction_mode	Prediction mode information true to allow the predictive text feature if available, false to disable the predictive text feature

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_NOT_RUNNING	IME main loop is not started yet

Postcondition:

Input panel UI should be drawn or operated by this information accordingly.

See also:

ime_show_cb()

Gets the Return key state information from the given input context.

Each edit field has various attributes for input panel. This function can be called to get the Return key state information in ime_show_cb() callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Parameters:

[in]	context	The input context information of an associated text input UI control
[out]	return_key_state	The Return key state information true to enable Return key button, false to disable Return key button

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_NOT_RUNNING	IME main loop is not started yet

Postcondition:

Input panel UI should be drawn or operated by this information accordingly.

See also:

ime_show_cb()

ime_return_key_state_set_cb()

Gets the Return key label type information from the given input context.

Each edit field has various attributes for input panel. This function can be called to get the Return key label type information in ime_show_cb() callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Parameters:

[in]	context	The input context information of an associated text input UI control
[out]	return_key_type	The Return key label type information

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_NOT_RUNNING	IME main loop is not started yet

Postcondition:

Input panel UI should be drawn or operated by this information accordingly.

See also:

ime_show_cb()

ime_return_key_type_set_cb()

Requests to create an option window from the input panel.

The input panel can call this function to open the option window. This function calls ime_option_window_created_cb() callback function with IME_OPTION_WINDOW_TYPE_KEYBOARD parameter.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_NO_CALLBACK_FUNCTION	Necessary callback function is not set
IME_ERROR_NOT_RUNNING	IME main loop is not started yet
IME_ERROR_OPERATION_FAILED	Operation failed

Precondition:

The ime_option_window_created_cb() and ime_option_window_destroyed_cb() callback functions MUST be set by ime_event_set_option_window_created_cb() and ime_event_set_option_window_destroyed_cb() respectively.

Postcondition:

This function calls ime_option_window_created_cb() callback function to create the option window. And ime_destroy_option_window() function can be called to close the option window.

See also:

ime_event_set_option_window_created_cb()

ime_option_window_created_cb()

ime_destroy_option_window()

Requests to delete surrounding text.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Parameters:

[in]	offset	The offset value from the cursor position
[in]	len	The length of the text to delete

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_NOT_RUNNING	IME main loop is not started yet

See also:

ime_request_surrounding_text()

Requests to destroy an option window.

The input panel can call this function to close the option window which is created from either the input panel or Settings application.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Parameters:

[in]

window

The option window to destroy

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_NO_CALLBACK_FUNCTION	Necessary callback function is not set
IME_ERROR_NOT_RUNNING	IME main loop is not started yet

Precondition:

The ime_option_window_created_cb() and ime_option_window_destroyed_cb() callback functions MUST be set by ime_event_set_option_window_created_cb() and ime_event_set_option_window_destroyed_cb() respectively.

Postcondition:

This function calls ime_option_window_destroyed_cb() callback function to destroy the option window.

See also:

ime_event_set_option_window_destroyed_cb()

ime_option_window_destroyed_cb()

ime_create_option_window()

Gets the device class of the key event.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Parameters:

[in]	dev_info	The device information from the key event
[out]	dev_class	The class of key input device. This can be ECORE_IMF_DEVICE_CLASS_NONE if the device class is not available

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_NOT_RUNNING	IME main loop is not started yet

See also:

ime_process_key_event_cb()

ime_device_info_get_name()

ime_device_info_get_subclass()

Gets the device name of the key event.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

dev_name must be released using free().

Parameters:

[in]	dev_info	The device information from the key event
[out]	dev_name	The name of key input device. This can be an empty string if the device name is not available

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_NOT_RUNNING	IME main loop is not started yet

See also:

ime_process_key_event_cb()

ime_device_info_get_class()

ime_device_info_get_subclass()

Gets the device subclass of the key event.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Parameters:

[in]	dev_info	The device information from the key event
[out]	dev_subclass	The subclass of key input device. This can be ECORE_IMF_DEVICE_SUBCLASS_NONE if the device subclass is not available

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_NOT_RUNNING	IME main loop is not started yet

See also:

ime_process_key_event_cb()

ime_device_info_get_name()

ime_device_info_get_class()

Sets accessibility_state_changed event callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

The ime_accessibility_state_changed_cb() callback function is called when Accessibility in Settings application is on or off.

Parameters:

[in]	callback_func	accessibility_state_changed event callback function
[in]	user_data	User data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_OPERATION_FAILED	Operation failed

Postcondition:

The ime_run() function should be called to start the IME application's main loop.

See also:

ime_accessibility_state_changed_cb()

ime_run()

Sets cursor_position_updated event callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

The ime_cursor_position_updated_cb() callback function is called when the position of the cursor in an associated text input UI control changes.

Parameters:

[in]	callback_func	cursor_position_updated event callback function
[in]	user_data	User data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_OPERATION_FAILED	Operation failed

Postcondition:

The ime_run() function should be called to start the IME application's main loop.

See also:

ime_cursor_position_updated_cb()

ime_run()

Sets display_language_changed event callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

The ime_display_language_changed_cb() callback function is called when the system display language is changed.

Parameters:

[in]	callback_func	display_language_changed event callback function
[in]	user_data	User data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_OPERATION_FAILED	Operation failed

Postcondition:

The ime_run() function should be called to start the IME application's main loop.

See also:

ime_display_language_changed_cb()

ime_run()

Sets focus_in event callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

The ime_focus_in_cb() callback function is called when an associated text input UI control has focus.

Parameters:

[in]	callback_func	focus_in event callback function
[in]	user_data	User data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_OPERATION_FAILED	Operation failed

Postcondition:

The ime_run() function should be called to start the IME application's main loop.

See also:

ime_focus_in_cb()

ime_run()

Sets focus_out event callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

The ime_focus_out_cb() callback function is called when an associated text input UI control loses focus.

Parameters:

[in]	callback_func	focus_out event callback function
[in]	user_data	User data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_OPERATION_FAILED	Operation failed

Postcondition:

The ime_run() function should be called to start the IME application's main loop.

See also:

ime_focus_out_cb()

ime_run()

Sets geometry_requested event callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

The ime_geometry_requested_cb() callback function is called when an associated text input UI control requests the position and size from the input panel.

Parameters:

[in]	callback_func	geometry_requested event callback function
[in]	user_data	User data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_OPERATION_FAILED	Operation failed

Postcondition:

The ime_run() function should be called to start the IME application's main loop.

See also:

ime_geometry_requested_cb()

ime_run()

Sets imdata_requested event callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

The ime_imdata_requested_cb() callback function is called when an associated text input UI control requests the application specific data from the input panel.

Parameters:

[in]	callback_func	imdata_requested event callback function
[in]	user_data	User data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_OPERATION_FAILED	Operation failed

Postcondition:

The ime_run() function should be called to start the IME application's main loop.

See also:

ime_imdata_requested_cb()

ime_event_set_imdata_set_cb()

ime_run()

Sets imdata_set event callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

The ime_imdata_set_cb() callback function is called to set the application specific data to deliver to the input panel.

Parameters:

[in]	callback_func	imdata_set event callback function
[in]	user_data	User data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_OPERATION_FAILED	Operation failed

Postcondition:

The ime_run() function should be called to start the IME application's main loop.

See also:

ime_imdata_set_cb()

ime_event_set_imdata_requested_cb()

ime_run()

Sets input_context_reset event callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

The ime_input_context_reset_cb() callback function is called to reset the input context of an associated text input UI control.

Parameters:

[in]	callback_func	input_context_reset event callback function
[in]	user_data	User data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_OPERATION_FAILED	Operation failed

Postcondition:

The ime_run() function should be called to start the IME application's main loop.

See also:

ime_input_context_reset_cb()

ime_run()

Sets language_requested event callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

The ime_language_requested_cb() callback function is called when an associated text input UI control requests the language from the input panel.

Parameters:

[in]	callback_func	language_requested event callback function
[in]	user_data	User data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_OPERATION_FAILED	Operation failed

Postcondition:

The ime_run() function should be called to start the IME application's main loop.

See also:

ime_language_requested_cb()

ime_run()

Sets language_set event callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

The ime_language_set_cb() callback function is called to set the preferred language to the input panel.

Parameters:

[in]	callback_func	language_set event callback function
[in]	user_data	User data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_OPERATION_FAILED	Operation failed

Postcondition:

The ime_run() function should be called to start the IME application's main loop.

See also:

ime_language_set_cb()

ime_run()

Sets layout_set event callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

The ime_layout_set_cb() callback function is called when an associated text input UI control requests the input panel to set its layout.

Parameters:

[in]	callback_func	layout_set event callback function
[in]	user_data	User data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_OPERATION_FAILED	Operation failed

Postcondition:

The ime_run() function should be called to start the IME application's main loop.

See also:

ime_layout_set_cb()

ime_run()

Sets MIME type event callback function.

Since :

4.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

The ime_mime_type_set_request_cb() callback function is called when an associated text input UI control requests the text entry to set the MIME type.

Parameters:

[in]	callback_func	MIME type event callback function
[in]	user_data	User data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter

Postcondition:

The ime_run() function should be called to start the IME application's main loop.

See also:

ime_mime_type_set_request_cb()

ime_run()

Sets option_window_created event callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

The ime_option_window_created_cb() callback function is called to create the option window.

Parameters:

[in]	callback_func	option_window_created event callback function
[in]	user_data	User data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_OPERATION_FAILED	Operation failed

Postcondition:

The ime_run() function should be called to start the IME application's main loop.

See also:

ime_option_window_created_cb()

ime_run()

Sets option_window_destroyed event callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

The ime_option_window_destroyed_cb() callback function is called to destroy the option window.

Parameters:

[in]	callback_func	option_window_destroyed event callback function
[in]	user_data	User data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_OPERATION_FAILED	Operation failed

Postcondition:

The ime_run() function should be called to start the IME application's main loop.

See also:

ime_option_window_destroyed_cb()

ime_run()

Sets a callback function to give a hint about predicted words.

Since :

5.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

The ime_prediction_hint_data_set_cb() callback function is called to provide the prediction hint key and value which can be delivered to the input panel.

Parameters:

[in]	callback_func	The callback function to give hints
[in]	user_data	User data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter

Postcondition:

The ime_run() function should be called to start the IME application's main loop.

See also:

ime_prediction_hint_data_set_cb()

ime_run()

Sets prediction hint event callback function.

Since :

4.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

The ime_prediction_hint_set_cb() callback function is called to set the prediction hint string to deliver to the input panel.

Parameters:

[in]	callback_func	The prediction hint event callback function
[in]	user_data	User data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function.
IME_ERROR_INVALID_PARAMETER	Invalid parameter

Postcondition:

The ime_run() function should be called to start the IME application's main loop.

See also:

ime_prediction_hint_set_cb()

ime_run()

Sets process_input_device_event event callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime

Remarks:

The ime_process_input_device_event_cb() callback function is called when the event is received from unconventional input devices that needs to be handled by IMEs.

Parameters:

[in]	callback_func	inputmethod_process_input_device_event_cb callback function
[in]	user_data	User data to be passed to the callback function

Returns:

0 on success, otherwise a negative error value

Return values:

IME_ERROR_NONE	No error
IME_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this function
IME_ERROR_INVALID_PARAMETER	Invalid parameter
IME_ERROR_OPERATION_FAILED	Operation failed

Postcondition:

The ime_run() function should be called to start to run IME application's main loop.

See also:

ime_process_input_device_event_cb()

ime_event_unset_process_input_device_event_cb()

ime_run()

 static void inputmethod_create_cb(void *user_data);
 static void inputmethod_terminate_cb(void *user_data);
 static void inputmethod_show_cb(int context_id, ime_context_h context, void *user_data);
 static void inputmethod_hide_cb(int context_id, void *user_data);

 static void inputmethod_process_input_device_event_cb(ime_input_device_type_e device_type, ime_input_device_event_h device_event, void *user_data)
 {
    if (device_type == IME_INPUT_DEVICE_TYPE_ROTARY) {
        dlog_print(DLOG_INFO, "INPUTMETHOD", "Input device type is rotary\n");
    }
 }

 void ime_app_main(int argc, char **argv)
 {
    ime_callback_s basic_callback = {
        inputmethod_create_cb,
        inputmethod_terminate_cb,
        inputmethod_show_cb,
        inputmethod_hide_cb,
    };

    ime_event_set_process_input_device_event_cb(inputmethod_process_input_device_event_cb, NULL);

    ime_run(&basic_callback, NULL);
 }

Sets process_key_event event callback function.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/ime