ImeMode 枚举
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
指定一个值，该值是用来确定在选定了对象时该对象的输入法编辑器 (IME) 的状态。
此 API 支持产品基础结构，不能在代码中直接使用。
public enum class ImeMode[System.Runtime.InteropServices.ComVisible(true)]
public enum ImeModepublic enum ImeMode[<System.Runtime.InteropServices.ComVisible(true)>]
type ImeMode = type ImeMode = Public Enum ImeMode- 继承
- 属性
| Alpha | 8 | 字母数字单字节字符 (SBC)。 此设置仅对朝鲜语和日语 IME 有效。 |
| AlphaFull | 7 | 字母数字双字节字符。 此设置仅对朝鲜语和日语 IME 有效。 |
| Close | 11 | IME 已关闭。 此设置仅对中文 IME 有效。 |
| Disable | 3 | IME 被禁用。 如果使用此设置，则用户无法从键盘打开 IME，而且 IME 浮动窗口处于隐藏状态。 |
| Hangul | 10 | 朝鲜文 SBC。 此设置仅对朝鲜语 IME 有效。 |
| HangulFull | 9 | 朝鲜文 DBC。 此设置仅对朝鲜语 IME 有效。 |
| Hiragana | 4 | 平假名 DBC。 此设置仅对日语 IME 有效。 |
| Inherit | -1 | 继承父控件的 IME 模式。 |
| Katakana | 5 | 片假名 DBC。 此设置仅对日语 IME 有效。 |
| KatakanaHalf | 6 | 片假名 SBC。 此设置仅对日语 IME 有效。 |
| NoControl | 0 | 无（默认）。 |
| Off | 2 | IME 已关闭。 此模式指示 IME 已关闭，这意味着该对象的行为方式与英语输入模式相同。 此设置仅对日语、简体中文和繁体中文 IME 有效。 |
| On | 1 | IME 已打开。 此值指示 IME 已打开，可以输入中文或日语特定的字符。 此设置仅对日语、简体中文和繁体中文 IME 有效。 |
| OnHalf | 12 | HalfShape 上的 IME。 此设置仅对中文 IME 有效。 |
以下示例演示如何设置控件 ImeMode 属性的值。
#using <System.Data.dll>
#using <System.Windows.Forms.dll>
#using <System.dll>
#using <System.Drawing.dll>
using namespace System;
using namespace System::Drawing;
using namespace System::Collections;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;
using namespace System::Data;
public ref class Form1: public System::Windows::Forms::Form
{
private:
RichTextBox^ rtb;
public:
Form1()
{
rtb = gcnew RichTextBox;
this->Controls->Add( rtb );
rtb->Dock = DockStyle::Fill;
this->InputLanguageChanged += gcnew InputLanguageChangedEventHandler( this, &Form1::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;
}
}
};
int main()
{
Application::Run( gcnew Form1 );
}
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());
}
}
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
输入法编辑器 (IME) 允许用户输入和编辑中文、日语和韩国字符。 IME 是编写中文、日语和韩国脚本的一个重要组成部分。 这些写入系统具有的字符数比常规键盘编码的字符多。 这些语言的 IME 使用描述单个字符或字符组的基字符序列，以便输入更大的字符集。 基字符可以是朝鲜文音节中的分量字母、日语汉字的拼音组件，也可以是中文字符的各种组合。
重要
用户可以以交互方式更改 Control.ImeMode ，除非已以编程方式将其设置为“禁用”。 在这种情况下，用户将无法使用 IME。
当ImeMode全局输入模式生效时，在Windows 8上忽略该属性。 有关详细信息，请参阅 将文本输入从Per-Thread切换到每用户。
| 产品 | 版本 |
|---|---|
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7 |