ImeMode Enumeración
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Especifica un valor que determina el estado IME (Editor de métodos de entrada) de un objeto cuando se selecciona.
Esta API admite la infraestructura de producto y no está pensada para usarse directamente en el código.
public enum class ImeMode
[System.Runtime.InteropServices.ComVisible(true)]
public enum ImeMode
public enum ImeMode
[<System.Runtime.InteropServices.ComVisible(true)>]
type ImeMode =
type ImeMode =
Public Enum ImeMode
- Herencia
- Atributos
Campos
Alpha | 8 | Caracteres de un solo byte (SBC) alfanuméricos. Esta configuración sólo es válida para el IME de coreano y japonés. |
AlphaFull | 7 | Caracteres de dos bytes alfanuméricos. Esta configuración sólo es válida para el IME de coreano y japonés. |
Close | 11 | IME cerrado. Esta configuración sólo es válida para el IME de chino. |
Disable | 3 | El IME está deshabilitado. Con esta configuración, los usuarios no pueden activar el IME mediante el teclado, y la ventana flotante del IME está oculta. |
Hangul | 10 | SBC hangul. Esta configuración sólo es válida para el IME de coreano. |
HangulFull | 9 | DBC hangul. Esta configuración sólo es válida para el IME de coreano. |
Hiragana | 4 | DBC hiragana. Esta configuración sólo es válida para el IME de japonés. |
Inherit | -1 | Hereda el modo IME del control principal. |
Katakana | 5 | DBC katakana. Esta configuración sólo es válida para el IME de japonés. |
KatakanaHalf | 6 | SBC katakana. Esta configuración sólo es válida para el IME de japonés. |
NoControl | 0 | Ninguno (valor predeterminado). |
Off | 2 | El IME está desactivado. Este modo indica que el IME está desactivado, es decir, el objeto se comporta de la misma manera que el modo de entrada inglés. Esta configuración sólo es válida para el IME de japonés, chino simplificado y chino tradicional. |
On | 1 | El IME está activado. Este valor indica que el IME está activado y se pueden escribir caracteres específicos del chino o del japonés. Esta configuración sólo es válida para el IME de japonés, chino simplificado y chino tradicional. |
OnHalf | 12 | IME en HalfShape. Esta configuración sólo es válida para el IME de chino. |
Ejemplos
En el ejemplo siguiente se muestra cómo establecer el valor de la propiedad de un control 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
Comentarios
Un Editor de métodos de entrada (IME) permite a los usuarios escribir y editar caracteres chinos, japoneses y coreanos. El IME es un componente esencial para escribir scripts chinos, japoneses y coreanos. Estos sistemas de escritura tienen más caracteres de los que se pueden codificar para un teclado normal. Las IME de estos idiomas usan secuencias de caracteres base que describen un carácter individual o un grupo de caracteres para permitirle escribir un conjunto de caracteres mayor. Los caracteres base pueden ser letras de componentes de sílabas hangul, componentes fonéticos para caracteres kanji japoneses o varias combinaciones para caracteres chinos.
Importante
El usuario puede cambiar interactivamente a Control.ImeMode menos que se haya establecido mediante programación en Deshabilitar. En este caso, el usuario no podrá usar el IME.
La ImeMode propiedad se omite en Windows 8 cuando el modo de entrada global está en vigor. Para obtener más información, consulta Cambiar entrada de texto cambiada de Per-Thread a Por usuario.