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>

Required Privileges

1. To use the Input Method Manager API, the application has to request permission by adding the following privilege to the tizen-manifest.xml file:

    <privileges>
        <privilege>http://tizen.org/privilege/imemanager</privilege>
    </privileges>

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.

Feature

The Input Method Manager is a module used to manage the installed IMEs. You can use it to open the installed IME list or selector menu after your IME application is installed, and guide the user to select the installed IME:

1. Showing the IME list
You can request the installed IME list menu to be opened. If a new IME has been installed, the user can see its name in the IME list, and can use the toggle button to enable the keyboard they want.
All keyboards enabled in the IME list are shown in the IME selector to allow the user to select them as the default keyboard.

2. Showing the IME selector
You can request the IME selector menu to be opened. When the user opens the IME selector menu, it shows all the keyboards enabled in the IME list.
The user can change the default keyboard by selecting a new one. By clicking 'Select keyboard', the user can return to the IME list menu to enable a new IME.

3. Checking the IME status
You can check whether a specific IME is enabled or disabled in the system keyboard setting.
You can also check which IME is currently selected as the default keyboard, or how many IMEs are enabled (usable).
These features are useful when the user installs a new keyboard.

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()