Export (0) Print
Expand All
Expand Minimize

Control.DefaultImeMode Property

Gets the default Input Method Editor (IME) mode supported by the control.

[Visual Basic]
Protected Overridable ReadOnly Property DefaultImeMode As ImeMode
[C#]
protected virtual ImeMode DefaultImeMode {get;}
[C++]
protected: __property virtual ImeMode get_DefaultImeMode();
[JScript]
protected function get DefaultImeMode() : ImeMode;

Property Value

One of the ImeMode values.

Remarks

An input method editor (IME) is a program that allows users to enter complex characters and symbols, such as Japanese Kanji characters, by using a standard keyboard.

As implemented in the Control class, this property always returns the ImeMode.Inherit value. The Inherit value specifies that the IME mode is inherited from the parent control.

Notes to Inheritors:  When overriding the DefaultImeMode property in a derived class, use the base class's DefaultImeMode property to extend the base implementation. Otherwise, you must provide all the implementation.

Example

[Visual Basic, C#, C++] The following example overrides the DefaultImeMode property to turn off the Input Method Editor.

[Visual Basic] 
Protected Overrides ReadOnly Property DefaultImeMode() As ImeMode
   Get
      ' Disable the IME mode for the control.
      Return ImeMode.Off
   End Get
End Property

[C#] 
protected override ImeMode DefaultImeMode
{
   get
   {
      // Disable the IME mode for the control.
      return ImeMode.Off;
   }
}

[C++] 
protected:
    __property System::Windows::Forms::ImeMode get_DefaultImeMode() {

        // Disable the IME mode for the control.
        return ImeMode::Off;

    }

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

Control Class | Control Members | System.Windows.Forms Namespace | ImeMode | Control.ImeMode

Show:
© 2015 Microsoft