ImeMode Enumeration
Assembly: System.Windows.Forms (in system.windows.forms.dll)
| Member name | Description | |
|---|---|---|
| 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 | ||
| 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. |
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.
The following example shows how to set the value of a control's ImeMode property.
Imports System Imports System.Drawing Imports System.Collections Imports System.ComponentModel Imports System.Windows.Forms Imports System.Data Public Class Form1 Inherits System.Windows.Forms.Form Dim WithEvents rtb As New RichTextBox() Public Sub New() MyBase.New() Me.Controls.Add(rtb) rtb.Dock = DockStyle.Fill End Sub Private Sub languageChange( _ ByVal sender As Object, _ ByVal e As InputLanguageChangedEventArgs _ ) Handles MyBase.InputLanguageChanged ' If the input language is Japanese. ' set the initial IMEMode to Katakana. If e.InputLanguage.Culture.TwoLetterISOLanguageName.Equals("ja") = True Then rtb.ImeMode = System.Windows.Forms.ImeMode.Katakana End If End Sub Public Shared Sub Main() Application.Run(new Form1()) End Sub End Class
import System.*;
import System.Drawing.*;
import System.Collections.*;
import System.ComponentModel.*;
import System.Windows.Forms.*;
import System.Data.*;
public class Form1 extends System.Windows.Forms.Form
{
private RichTextBox rtb = new RichTextBox();
public Form1()
{
this.get_Controls().Add(rtb);
rtb.set_Dock(DockStyle.Fill);
this.add_InputLanguageChanged(
new InputLanguageChangedEventHandler(LanguageChange));
} //Form1
private void LanguageChange(Object sender, InputLanguageChangedEventArgs e)
{
// If the input language is Japanese.
// set the initial IMEMode to Katakana.
if (e.get_InputLanguage().get_Culture().get_TwoLetterISOLanguageName().
Equals("ja")) {
rtb.set_ImeMode(System.Windows.Forms.ImeMode.Katakana);
}
} //LanguageChange
public static void main(String[] args)
{
Application.Run(new Form1());
} //main
} //Form1
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.