System.Windows.Forms.ImeMode Enumeration

Specifies a value that determines the Input Method Editor (IME) status of an object when the object is selected.

Syntax

[System.Runtime.InteropServices.ComVisible(true)]
public enum ImeMode

Remarks

An Input Method Editor (IME) allows users to enter and edit Chinese, Japanese, and Korean characters. The IME is an essential component for writing Chinese, Japanese, and Korean scripts. These writing systems have more characters than can be encoded for a regular keyboard. The IMEs for these languages use sequences of base characters that describe an individual character or group of characters to allow you to enter a larger set of characters. Base characters can be component letters from Hangul syllables, phonetic components for Japanese Kanji characters, or various combinations for Chinese characters.

Note:

The user can interactively change the Control.ImeMode unless it has been programmatically set to ImeMode.Disable. In this case, the user will not be able to use the IME.

The Control.ImeMode property is ignored on Windows 8 when the global input mode is in effect. For more info, see tp://go.microsoft.com/fwlink/?LinkID=256509.

Members

Member NameDescription
Alpha

Alphanumeric single-byte characters(SBC). This setting is valid for Korean and Japanese IME only.

AlphaFull

Alphanumeric double-byte characters. This setting is valid for Korean and Japanese IME only.

Close

IME closed. This setting is valid for Chinese IME only.

Disable

The IME is disabled. With this setting, the users cannot turn the IME on from the keyboard, and the IME floating window is hidden.

Hangul

Hangul SBC. This setting is valid for the Korean IME only.

HangulFull

Hangul DBC. This setting is valid for the Korean IME only.

Hiragana

Hiragana DBC. This setting is valid for the Japanese IME only.

Inherit

Inherits the IME mode of the parent control.

Katakana

Katakana DBC. This setting is valid for the Japanese IME only.

KatakanaHalf

Katakana SBC. This setting is valid for the Japanese IME only.

NoControl

None (Default).

Off

The IME is off. This mode indicates that the IME is off, meaning that the object behaves the same as English entry mode. This setting is valid for Japanese, Simplified Chinese, and Traditional Chinese IME only.

On

The IME is on. This value indicates that the IME is on and characters specific to Chinese or Japanese can be entered. This setting is valid for Japanese, Simplified Chinese, and Traditional Chinese IME only.

OnHalf

IME on HalfShape. This setting is valid for Chinese IME only.

Requirements

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0