Export (0) Print
Expand All
Expand Minimize

Control.ImeMode Property

Gets or sets the Input Method Editor (IME) mode of the control.

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

public ImeMode ImeMode { get; set; }

Property Value

Type: System.Windows.Forms.ImeMode
One of the ImeMode values. The default is Inherit.

ExceptionCondition
InvalidEnumArgumentException

The assigned value is not one of the ImeMode enumeration values.

An IME is a program that enables users to enter complex characters and symbols, such as Japanese Kanji characters, using a standard keyboard. The ImeMode property is typically set to ImeMode.Off for a TextBox control that is intended to only enter numeric values. The ImeMode property value is set to ImeMode.NoControl for the Form class.

Most classes that do not directly support Input Method Editors, or allow direct input from an IME, will set the value of this property to NoControl.

Important noteImportant

The user can interactively change the 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.

.NET Framework

Supported in: 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