Export (0) Print
Expand All
Expand Minimize

ImeMode Enumeration

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

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

[ComVisibleAttribute(true)]
public enum ImeMode

Member nameDescription
AlphaAlphanumeric single-byte characters(SBC). This setting is valid for Korean and Japanese IME only.
AlphaFullAlphanumeric double-byte characters. This setting is valid for Korean and Japanese IME only.
CloseIME closed. This setting is valid for Chinese IME only.
DisableThe IME is disabled. With this setting, the users cannot turn the IME on from the keyboard, and the IME floating window is hidden.
HangulHangul SBC. This setting is valid for the Korean IME only.
HangulFullHangul DBC. This setting is valid for the Korean IME only.
HiraganaHiragana DBC. This setting is valid for the Japanese IME only.
InheritInherits the IME mode of the parent control.
KatakanaKatakana DBC. This setting is valid for the Japanese IME only.
KatakanaHalfKatakana SBC. This setting is valid for the Japanese IME only.
NoControlNone (Default).
OffThe 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.
OnThe 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.
OnHalfIME on HalfShape. This setting is valid for Chinese IME only.

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.

Important noteImportant

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 ImeMode property is ignored on Windows 8 when the global input mode is in effect. For more info, see Switch Text Input Changed from Per-Thread to Per-User.

The following example shows how to set the value of a control's ImeMode property.

using System;
using System.Drawing;
using System.Collections;
using System.ComponentModel;
using System.Windows.Forms;
using System.Data;

public class Form1 : System.Windows.Forms.Form
{
	RichTextBox rtb = new RichTextBox();
	public Form1()
	{
		this.Controls.Add(rtb);
		rtb.Dock = DockStyle.Fill;
		this.InputLanguageChanged += new InputLanguageChangedEventHandler(languageChange);
	}
	private void languageChange(Object sender, InputLanguageChangedEventArgs e)
	{
		// If the input language is Japanese. 
		// set the initial IMEMode to Katakana. 
		if (e.InputLanguage.Culture.TwoLetterISOLanguageName.Equals("ja"))
		{
			rtb.ImeMode = System.Windows.Forms.ImeMode.Katakana;
		}
	}
	public static void Main(string[] args)
	{
		Application.Run(new Form1());
	}
}

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft