Control Properties


.NET Framework Class Library
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)

Syntax

Visual Basic (Declaration)
<LocalizableAttribute(True)> _
Public Property ImeMode As ImeMode
Visual Basic (Usage)
Dim instance As Control
Dim value As ImeMode

value = instance.ImeMode

instance.ImeMode = value
C#
[LocalizableAttribute(true)] 
public ImeMode ImeMode { get; set; }
C++
[LocalizableAttribute(true)] 
public:
property ImeMode ImeMode {
    ImeMode get ();
    void set (ImeMode value);
}
J#
/** @property */
public ImeMode get_ImeMode ()

/** @property */
public void set_ImeMode (ImeMode value)
JScript
public function get ImeMode () : ImeMode

public function set ImeMode (value : ImeMode)

Property Value

One of the ImeMode values. The default is Inherit.
Exceptions

Exception typeCondition

InvalidEnumArgumentException

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

Remarks

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.

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.

Platforms

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

Version Information

.NET Framework

Supported in: 2.0, 1.1, 1.0
See Also

Tags :


Page view tracker