ImSetCurrentIME

ImSetCurrentIME

Applications can change an IME directly by setting a IME ID with this function. And also applications can change the IME one by one according to the order of IME List.

Format:

APIRET APIENTRY ImSetCurrentIME(HIMI hIMI, ULONG ulAction, ULONG ImeId)

Parameters:

hIMI

- a handle of a IM Instance
ulAction(input)
- This can be one of the following values.

┌──────────────────────────────┬──────────────────────────────────────────────────┐
│Value                         │Action                                            │
├──────────────────────────────┼──────────────────────────────────────────────────┤
│SCI_NOIME                     │Removes IME                                       │
├──────────────────────────────┼──────────────────────────────────────────────────┤
│SCI_NEXT                      │Changes IME to the next one in the IME List. If   │
│                              │it's the last of the list, go back to the first   │
│                              │one.                                              │
├──────────────────────────────┼──────────────────────────────────────────────────┤
│SCI_PREVIOUS                  │Changes IME to the previous one in the IME List.  │
│                              │If it's the first of the list, go forward to the  │
│                              │last one.                                         │
├──────────────────────────────┼──────────────────────────────────────────────────┤
│SCI_SETBYID                   │Sets IME by specifying its IME ID. The ID is set  │
│                              │in ImeId.                                         │
└──────────────────────────────┴──────────────────────────────────────────────────┘

ImeId(input)
- an IME ID. This is valid only when ulAction is SCI_SETBYID.
Return:

Zero is successful. Others are errors.