ImmSetConversionStatus function (immdev.h)

Article
02/22/2024

Sets the current conversion status.

Syntax

BOOL ImmSetConversionStatus(
  [in] HIMC  unnamedParam1,
  [in] DWORD unnamedParam2,
  [in] DWORD unnamedParam3
);

Parameters

[in] unnamedParam1

Handle to the input context.

[in] unnamedParam2

Conversion mode values. For more information, see IME Conversion Mode Values.

[in] unnamedParam3

Sentence mode values. For more information, see IME Sentence Mode Values.

Return value

Returns a nonzero value if successful, or 0 otherwise.

Remarks

This function sends the IMN_SETCONVERSIONMODE and IMN_SETSENTENCEMODE commands to the application.

Note Beginning with Windows 8: By default, the input switch is set per user instead of per thread. The Microsoft IME (Japanese) respects the mode globally, and therefore ImmSetConversionStatus fails when getting focus.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only],East Asian language support installed.
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	immdev.h (include Immdev.h, Windows.h)
Library	Imm32.lib
DLL	Imm32.dll