IMEConvert Method (TDBText)

Reference> TDBText Control> TDBText Control Methods> IMEConvert Method (TDBText)

The IMEConvert method is useful for international developers using Japanese characters. It allows you to start up the IME by passing a Katakana (both DBCS and SBCS) or Hiragana string to the Yomi argument, which lists all the possible characters that can be converted into. This feature is very useful and effective when inputting data such as names and addresses, which reduces time and keystrokes for repeat entries.

Syntax

TDBText.IMEConvertYomi, IMEConvert

Arguments

Yomi is a required string: the Katakana (both DBCS and SBCS) and Hiragana text strings that you want to convert.

IMEConvert is a required constant that determines the converting status of the IME.

The IMEConvert argument has these settings:

0	The IME window will not be displayed.
1	Drop down the IME window.
2	Choose the first item from the IME list without displaying the window.

Return Value

None

Remarks

The IMEConvert method will be ignored if the focus is not set to the specified control. You must activate the control before invoking this method.

If the AutoConvert property is set to 1-Non-convert, this method will also not take effect, since the Yomi text string passed in will be immediately confirmed.

This method will take effect only when the IME is disabled.