Control.ImeMode-Eigenschaft

Artikel
08/20/2007

Ruft den IME-Modus (Eingabemethoden-Editor) des Steuerelements ab oder legt diesen fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
<LocalizableAttribute(True)> _
Public Property ImeMode As ImeMode
'Usage
Dim instance As Control
Dim value As ImeMode

value = instance.ImeMode

instance.ImeMode = value

[LocalizableAttribute(true)] 
public ImeMode ImeMode { get; set; }

[LocalizableAttribute(true)] 
public:
property ImeMode ImeMode {
    ImeMode get ();
    void set (ImeMode value);
}

/** @property */
public ImeMode get_ImeMode ()

/** @property */
public void set_ImeMode (ImeMode value)

public function get ImeMode () : ImeMode

public function set ImeMode (value : ImeMode)

Eigenschaftenwert

Einer der ImeMode-Werte. Der Standardwert ist Inherit.

Ausnahmen

Ausnahmetyp	Bedingung
InvalidEnumArgumentException	Der zugewiesene Wert ist keiner der ImeMode-Enumerationswerte.

Hinweise

Ein IME ist ein Programm, mit dem der Benutzer komplexe Zeichen und Symbole, z. B. japanische Kanji-Zeichen, über eine Standardtastatur eingeben kann. Für ein TextBox-Steuerelement, in dem nur numerische Werte eingegeben werden sollen, wird die ImeMode-Eigenschaft i. d. R auf ImeMode.Off festgelegt. Der Wert der ImeMode-Eigenschaft wird für die Form-Klasse auf ImeMode.NoControl festgelegt.

Die meisten Klassen, die Eingabemethoden-Editoren nicht direkt unterstützen oder die direkte Eingabe von einem Eingabemethoden-Editor (IME ) zulassen, legen den Wert für diese Eigenschaft auf NoControl fest.

Wichtig

Der Benutzer kann den ImeMode interaktiv ändern, sofern dieser nicht programmgesteuert auf ImeMode.Disable festgelegt wurde. In diesem Fall ist der Benutzer nicht in der Lage, den IME zu verwenden.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Windows.Forms-Namespace
ImeMode
Control.DefaultImeMode-Eigenschaft

Freigeben über