Tizen Native API  9.0
Functions
Input Method Manager
UIX

The Input Method Manager API provides the functions for launching input method editor (IME) list and selector settings. A user can manage the installed IMEs in the system.

Required Header

#include <inputmethod_manager.h>

Overview

Input method editor (IME) is an input panel that lets users provide input and the platform receive the text data entered. Input method manager is a module for managing the installed IMEs. IME developers can use this module to open the installed IME list or selector menu after their IME installation; then guide to select the installed IME.

Functions

int ime_manager_show_ime_list (void)
 Requests to open the installed IME list menu.
int ime_manager_show_ime_selector (void)
 Requests to open the IME selector menu. Disabled IMEs are not displayed in the IME Selector.
int ime_manager_is_ime_enabled (const char *app_id, bool *enabled)
 Checks if the specific IME is enabled or disabled in the system keyboard setting.
int ime_manager_get_active_ime (char **app_id)
 Checks which IME is the current activated (selected) IME.
int ime_manager_get_enabled_ime_count (void)
 Gets the number of IMEs which are enabled (usable).
int ime_manager_prelaunch_ime (void)
 Requests to pre-launch the IME. Otherwise, the IME will be launched when an associated text input UI control has focus.

Enumeration Type Documentation

enum ime_manager_error_e

Enumeration for input method manager function error.

Since :
2.4
Enumerator:
IME_MANAGER_ERROR_NONE 

Successful

IME_MANAGER_ERROR_INVALID_PARAMETER 

Invalid parameter

IME_MANAGER_ERROR_PERMISSION_DENIED 

Permission denied

IME_MANAGER_ERROR_OPERATION_FAILED 

Operation failed

Function Documentation

int ime_manager_get_active_ime ( char **  app_id)

Checks which IME is the current activated (selected) IME.

Since :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/imemanager
Remarks:
app_id must be released using free().
Parameters:
[out]app_idThe application ID of the active IME
Returns:
0 on success, otherwise a negative error value
Return values:
IME_MANAGER_ERROR_NONENo error
IME_MANAGER_ERROR_PERMISSION_DENIEDThe application does not have the privilege to call this function
IME_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
IME_MANAGER_ERROR_OPERATION_FAILEDOperation failed
See also:
ime_manager_show_ime_selector()
int ime_manager_get_enabled_ime_count ( void  )

Gets the number of IMEs which are enabled (usable).

Since :
3.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/imemanager
Remarks:
The specific error code can be obtained using the get_last_result() method. Error codes are described in Exception section.
Returns:
The number of enabled IMEs on success, otherwise 0
Exceptions:
IME_MANAGER_ERROR_NONESuccessful
IME_MANAGER_ERROR_PERMISSION_DENIEDThe application does not have the privilege to call this function
IME_MANAGER_ERROR_OPERATION_FAILEDOperation failed
See also:
ime_manager_is_ime_enabled()
ime_manager_show_ime_selector()
int ime_manager_is_ime_enabled ( const char *  app_id,
bool *  enabled 
)

Checks if the specific IME is enabled or disabled in the system keyboard setting.

The IME developers can use this function to check their IME is enabled or not.

Since :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/imemanager
Parameters:
[in]app_idThe application ID of the IME
[out]enabledThe On (enabled) and Off (disabled) state of the IME
Returns:
0 on success, otherwise a negative error value
Return values:
IME_MANAGER_ERROR_NONENo error
IME_MANAGER_ERROR_PERMISSION_DENIEDThe application does not have the privilege to call this function
IME_MANAGER_ERROR_INVALID_PARAMETERInvalid parameter
IME_MANAGER_ERROR_OPERATION_FAILEDOperation failed
See also:
ime_manager_show_ime_list()
int ime_manager_prelaunch_ime ( void  )

Requests to pre-launch the IME. Otherwise, the IME will be launched when an associated text input UI control has focus.

The developers can use this function to launch IME in On-demand mode.

Since :
5.0
Privilege Level:
public
Privilege:
http://tizen.org/privilege/imemanager
Returns:
0 on success, otherwise a negative error value
Return values:
IME_MANAGER_ERROR_NONENo error
IME_MANAGER_ERROR_PERMISSION_DENIEDThe application does not have the privilege to call this function
IME_MANAGER_ERROR_OPERATION_FAILEDOperation failed
int ime_manager_show_ime_list ( void  )

Requests to open the installed IME list menu.

This function provides the installed IME list menu for the IME developers who might want to open it to enable their IME.

Since :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/imemanager
Returns:
0 on success, otherwise a negative error value
Return values:
IME_MANAGER_ERROR_NONENo error
IME_MANAGER_ERROR_PERMISSION_DENIEDThe application does not have the privilege to call this function
IME_MANAGER_ERROR_OPERATION_FAILEDOperation failed
See also:
ime_manager_show_ime_selector()
int ime_manager_show_ime_selector ( void  )

Requests to open the IME selector menu. Disabled IMEs are not displayed in the IME Selector.

This function provides the IME selector menu for the IME or other application developers who might want to change the default IME.

Since :
2.4
Privilege Level:
public
Privilege:
http://tizen.org/privilege/imemanager
Returns:
0 on success, otherwise a negative error value
Return values:
IME_MANAGER_ERROR_NONENo error
IME_MANAGER_ERROR_PERMISSION_DENIEDThe application does not have the privilege to call this function
IME_MANAGER_ERROR_OPERATION_FAILEDOperation failed
See also:
ime_manager_show_ime_list()