TScreen.Imes Property

Lists all input method editors (IMEs) installed on the system.

Pascal

property Imes: TStrings;

C++

__property TStrings Imes;

Description

Read Imes to obtain a list of all Imes that are listed in the Windows registry. An IME is a front-end input processor for Asian language characters. The IME hooks all keyboard input, converts it to Asian characters in a conversion window, and sends the converted characters or strings on to the application. IMEs vary in user interface, conversion dictionaries, and input method.

Individual controls can require a specific IME to process the keyboard input when they have focus. To specify an IME, the control sets its ImeName property to one of the strings in Imes.

Each IME name in Imes has an associated keyboard layout handle. A keyboard layout handle is a Windows handle that identifies the primary language and IME used to process keyboard input. Use the keyboard layout handle in Windows API calls for programming the IME. To get the keyboard layout handle for a particular IME, a control can use code such as the following:

Copy Code

HKeyboard := Screen.Imes.Objects(Screen.Imes.IndexOf(ImeName));

Copy Code

HKeyboard = Screen->Imes->Objects(Screen->Imes->IndexOf(ImeName));