BOOL ImeConfigure(HKL hKL, HWND hWnd, DWORD dwMode, LPVOID lpData )
Provides a dialog box to request optional information for an IME.
· If successful, the return value is TRUE. Otherwise, it is FALSE.
IME_CONFIG_GENERAL | The dialog box for general purpose configuration. |
IME_CONFIG_REGWORD | The dialog box for registered word. |
IME_CONFIG_SELECTDICTIONARY | The dialog box for selecting the dictionary of the IME. |
This also can be NULL with IME_CONFIG_REGISTER mode if no initial string information is given.
An IME checks lpData as shown in the following pseudo code:
if (dwmode != IME_CONFIG_REGISTERWORD) {
// Does original execution
} else if (IsBadReadPtr(lpdata, sizeof(REGISTERWORD))==FALSE) {
if (IsBadStringPtr(PREGISTERWORD(lpdata)->lpReading,
(UINT)-1)==FALSE) {
// Set the reading string to word-registering dialog box
}
if (IsBadStringPtr(PREGISTERWORD(lpdata)->lpWord,
(UINT)-1)==FALSE) {
// Set the word string to word-registering dialog box
}
}