ImeMode Enumeration

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt einen Wert an, der den IME-Status (IME - Eingabemethoden-Editor) eines ausgewählten Objekts bestimmt.

Diese API unterstützt die Produktinfrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code gedacht.

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

Vererbung: Object

ValueType

Enum
ImeMode

Attribute: ComVisibleAttribute

Felder

Alpha	8	Alphanumerische Einzelbytezeichen (SBC, Single-Byte Characters). Diese Einstellung ist nur für IMEs für Koreanisch und Japanisch gültig.
AlphaFull	7	Alphanumerische Doppelbytezeichen. Diese Einstellung ist nur für IMEs für Koreanisch und Japanisch gültig.
Close	11	IME gschlossen. Diese Einstellung ist nur für den IME für Chinesisch gültig.
Disable	3	Der IME ist deaktiviert. Bei dieser Einstellung kann der Benutzer den IME nicht über die Tastatur aktivieren, und das unverankerte IME-Fenster ist ausgeblendet.
Hangul	10	Hangul-SBC (Single-Byte Characters, Einzelbytezeichen). Diese Einstellung ist nur für den IME für Koreanisch gültig.
HangulFull	9	Hangul-DBC (Double-Byte Characters, Doppelbytezeichen). Diese Einstellung ist nur für den IME für Koreanisch gültig.
Hiragana	4	Hiragana-DBC (Double-Byte Characters, Doppelbytezeichen). Diese Einstellung ist nur für den IME für Japanisch gültig.
Inherit	-1	Erbt den IME-Modus vom übergeordneten Steuerelement.
Katakana	5	Katakana-DBC (Double-Byte Characters, Doppelbytezeichen). Diese Einstellung ist nur für den IME für Japanisch gültig.
KatakanaHalf	6	Katakana-SBC (Single-Byte Characters, Einzelbytezeichen). Diese Einstellung ist nur für den IME für Japanisch gültig.
NoControl	0	Kein (Standardwert).
Off	2	Der IME ist deaktiviert. Dieser Modus gibt an, dass der IME deaktiviert ist. Das bedeutet, dass das Objekt sich wie im englischen Eingabemodus verhält. Diese Einstellung ist nur für IMEs für Japanisch und Chinesisch (vereinfacht und traditionell) gültig.
On	1	Der IME ist aktiviert. Dieser Wert gibt an, dass der IME aktiviert ist und für Chinesisch oder Japanisch spezifische Zeichen eingegeben werden können. Diese Einstellung ist nur für IMEs für Japanisch und Chinesisch (vereinfacht und traditionell) gültig.
OnHalf	12	IME auf HalfShape. Diese Einstellung ist nur für den IME für Chinesisch gültig.

Beispiele

Das folgende Beispiel zeigt, wie Sie den Wert der Eigenschaft eines Steuerelements ImeMode festlegen.

#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

Hinweise

Mit einem Eingabemethoden-Editor (IME) können Benutzer Chinesisch, Japanisch und Koreanisch eingeben und bearbeiten. Das IME ist eine wesentliche Komponente zum Schreiben chinesischer, japanischer und koreanischer Skripts. Diese Schreibsysteme verfügen über mehr Zeichen als für eine normale Tastatur codiert werden können. Die IMEs für diese Sprachen verwenden Sequenzen von Basiszeichen, die ein einzelnes Zeichen oder eine Einzelne Gruppe von Zeichen beschreiben, damit Sie eine größere Anzahl von Zeichen eingeben können. Basiszeichen können Komponentenbuchstaben aus Hangul-Silben, phonetischen Komponenten für japanische Kanji-Zeichen oder verschiedene Kombinationen für chinesische Zeichen sein.

Wichtig

Der Benutzer kann die Control.ImeMode Option interaktiv ändern, es sei denn, er wurde programmgesteuert auf "Deaktivieren" festgelegt. In diesem Fall kann der Benutzer den IME nicht verwenden.

Die ImeMode Eigenschaft wird bei Windows 8 ignoriert, wenn der globale Eingabemodus wirksam ist. Weitere Informationen finden Sie unter Wechseln der Texteingabe von Per-Thread zu "Pro Benutzer".

Gilt für