ImQueryIMMode

ImQueryIMMode

Applications can query the current input mode, conversion mode, and open status.

Format:

APIRET APIENTRY ImQueryIMMode(HIMI hIMI, PULONG pulInputMode, PULONG pulConversionMode)

Parameters:

hIMI(input)

- a handle of a IM Instance
pulInputMode(output)
- IME input mode or IME's on/off

┌──────────────────────────────┬────────────────────────────────────────┐
│Conversion_Mode               │Description                             │
├──────────────────────────────┼────────────────────────────────────────┤
│IMI_IM_NLS_ALPHANUMERIC       │Alphanumeric mode                       │
├──────────────────────────────┼────────────────────────────────────────┤
│IMI_IM_NLS_HIRAGANA           │HIRAGANA mode                           │
├──────────────────────────────┼────────────────────────────────────────┤
│IMI_IM_NLS_KATAKANA           │KATAKANA mode                           │
├──────────────────────────────┼────────────────────────────────────────┤
│IMI_IM_WIDTH_HALF             │HANKAKU mode                            │
├──────────────────────────────┼────────────────────────────────────────┤
│IMI_IM_WIDTH_FULL             │ZENKAKU mode                            │
├──────────────────────────────┼────────────────────────────────────────┤
│IMI_IM_ROMAJI_OFF             │Not in ROMAJI mode                      │
├──────────────────────────────┼────────────────────────────────────────┤
│IMI_IM_ROMAJI_ON              │ROMAJI mode                             │
├──────────────────────────────┼────────────────────────────────────────┤
│IMI_IM_SYSTEMROMAJI_ENABLE    │System ROMAJI translation is enabled.   │
│                              │IME doesn't support ROMAJI translation. │
├──────────────────────────────┼────────────────────────────────────────┤
│IMI_IM_SYSTEMROMAJI_DISABLE   │System ROMAJI translation is disabled.  │
│                              │IME supports ROMAJI translation by      │
│                              │itself                                  │
├──────────────────────────────┼────────────────────────────────────────┤
│IMI_IM_IME_OFF                │IME is turned off.                      │
├──────────────────────────────┼────────────────────────────────────────┤
│IMI_IM_IME_ON                 │IME is turned on and active.            │
├──────────────────────────────┼────────────────────────────────────────┤
│IMI_IM_IME_ENABLE             │IME is enabled.                         │
├──────────────────────────────┼────────────────────────────────────────┤
│IMI_IM_IME_DISABLE            │IME is disabled. Any input are not      │
│                              │passed to IME.                          │
└──────────────────────────────┴────────────────────────────────────────┘

pulConversionMode(output)
- a conversion mode

┌──────────────────────────────┬──────────────────────────────────────────────────┐
│Conversion_Mode               │Description                                       │
├──────────────────────────────┼──────────────────────────────────────────────────┤
│IMI_CM_AUTOMATIC              │IME converts strings automatically.               │
├──────────────────────────────┼──────────────────────────────────────────────────┤
│IMI_CM_PREDICT                │IME uses phrase information to predict the next   │
│                              │character.                                        │
├──────────────────────────────┼──────────────────────────────────────────────────┤
│IMI_CM_PLURALCLAUSE           │IME uses plural clause information to convert     │
│                              │strings.                                          │
├──────────────────────────────┼──────────────────────────────────────────────────┤
│IMI_CM_SINGLE                 │IME converts strings in single character mode     │
└──────────────────────────────┴──────────────────────────────────────────────────┘

Return:

Zero is successful. Others are errors.