Freigeben über


InputLanguage-Klasse

Stellt Methoden und Felder zum Verwalten der Eingabesprache bereit. Die Klasse kann nicht vererbt werden.

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

Syntax

'Declaration
Public NotInheritable Class InputLanguage
'Usage
Dim instance As InputLanguage
public sealed class InputLanguage
public ref class InputLanguage sealed
public final class InputLanguage
public final class InputLanguage

Hinweise

Eine Eingabesprache ist eine Kombination aus Kultur und Tastaturlayout, die bestimmt, wie die Zeichen einer Sprache den Tasten auf einer Tastatur zugeordnet oder grafisch dargestellt werden. Die Eingabesprache beruht auf einem Bezeichner für das Windows-Eingabegebietsschema, wie dem, der von der Funktion Platform SDK zurückgegeben wurde, GetKeyboardLayout. Der Eingabegebietsschemabezeichner wird auch als HKL (Handle to a Keyboard Layout)-Wert bezeichnet.

Verwenden Sie die bereitgestellten static-Methoden, wenn Sie alle installierten Zuordnungen des Systems finden oder die Eingabesprache für einen Thread oder einen Prozess ändern möchten. Rufen Sie CurrentInputLanguage auf, um die aktuelle Eingabesprache abzurufen. Rufen Sie DefaultInputLanguage auf, um die Standardeingabesprache abzurufen. Rufen Sie InstalledInputLanguages auf, um alle im System installierten Sprachen abzurufen. Nachdem Sie über eine Liste aller installierten Sprachen verfügen, können Sie mit CurrentInputLanguage die aktuelle Eingabesprache ändern.

Beispiel

Im folgenden Codebeispiel wird eine Liste aller installierten Sprachen abgerufen. Das Beispiel erfordert, dass textBox1 als Instanz definiert und textBox1.MultiLine auf true festgelegt wurde.

Public Sub GetLanguages()
    ' Gets the list of installed languages.
    Dim lang As InputLanguage
    For Each lang In  InputLanguage.InstalledInputLanguages
        textBox1.Text &= lang.Culture.EnglishName & ControlChars.Cr
    Next lang
End Sub 'GetLanguages
public void GetLanguages() {
    // Gets the list of installed languages.
    foreach(InputLanguage lang in InputLanguage.InstalledInputLanguages) {
       textBox1.Text += lang.Culture.EnglishName + '\n';
    }
}
public:
   void GetLanguages()
   {
      // Gets the list of installed languages.
      for each ( InputLanguage^ lang in InputLanguage::InstalledInputLanguages )
      {
         textBox1->Text = String::Concat( textBox1->Text, lang->Culture->EnglishName, "\n" );
      }
   }
public void GetLanguages()
{
    // Gets the list of installed languages.
    IEnumerator objEnum = InputLanguage.get_InstalledInputLanguages().
        GetEnumerator();
    while (objEnum.MoveNext()) {
        InputLanguage lang = (InputLanguage)objEnum.get_Current();
        textBox1.set_Text(textBox1.get_Text() + lang.get_Culture().
            get_EnglishName() + '\n');
    }
} //GetLanguages

Im nächsten Beispiel wird die Standardeingabesprache als aktuelle Eingabesprache festgelegt. Das Beispiel erfordert, dass textBox1 als Instanz definiert und textBox1.MultiLine auf true festgelegt wurde.

Public Sub SetNewCurrentLanguage()
    ' Gets the default, and current languages.
    Dim myDefaultLanguage As InputLanguage = InputLanguage.DefaultInputLanguage
    Dim myCurrentLanguage As InputLanguage = InputLanguage.CurrentInputLanguage
    textBox1.Text = "Current input language is: " & _
        myCurrentLanguage.Culture.EnglishName & ControlChars.Cr
        
    textBox1.Text &= "Default input language is: " & _
        myDefaultLanguage.Culture.EnglishName & ControlChars.Cr
    
    ' Changes the current input language to the default, and prints the new current language.
    InputLanguage.CurrentInputLanguage = myDefaultLanguage
    textBox1.Text &= "Current input language is now: " & _
        myDefaultLanguage.Culture.EnglishName
End Sub 'SetNewCurrentLanguage
public void SetNewCurrentLanguage() {
    // Gets the default, and current languages.
    InputLanguage myDefaultLanguage = InputLanguage.DefaultInputLanguage;
    InputLanguage myCurrentLanguage = InputLanguage.CurrentInputLanguage;
    textBox1.Text = "Current input language is: " + myCurrentLanguage.Culture.EnglishName + '\n';
    textBox1.Text += "Default input language is: " + myDefaultLanguage.Culture.EnglishName + '\n';
 
    // Changes the current input language to the default, and prints the new current language.
    InputLanguage.CurrentInputLanguage = myDefaultLanguage;
    textBox1.Text += "Current input language is now: " + myDefaultLanguage.Culture.EnglishName;
}
public:
   void SetNewCurrentLanguage()
   {
      
      // Gets the default, and current languages.
      InputLanguage^ myDefaultLanguage = InputLanguage::DefaultInputLanguage;
      InputLanguage^ myCurrentLanguage = InputLanguage::CurrentInputLanguage;
      textBox1->Text = String::Format( "Current input language is: {0}\nDefault input language is: {1}\n",
         myCurrentLanguage->Culture->EnglishName, myDefaultLanguage->Culture->EnglishName );
      
      // Changes the current input language to the default, and prints the new current language.
      InputLanguage::CurrentInputLanguage = myDefaultLanguage;
      textBox1->Text = String::Format( "{0}Current input language is now: {1}",
         textBox1->Text, myDefaultLanguage->Culture->EnglishName );
   }
public void SetNewCurrentLanguage()
{
    // Gets the default, and current languages.
    InputLanguage myDefaultLanguage =
        InputLanguage.get_DefaultInputLanguage();
    InputLanguage myCurrentLanguage =
        InputLanguage.get_CurrentInputLanguage();
    textBox1.set_Text("Current input language is: "
        + myCurrentLanguage.get_Culture().get_EnglishName() + '\n');
    textBox1.set_Text(textBox1.get_Text() + "Default input language is: "
        + myDefaultLanguage.get_Culture().get_EnglishName() + '\n');

    // Changes the current input language to the default, 
    // and prints the new current language.
    InputLanguage.set_CurrentInputLanguage(myDefaultLanguage);
    textBox1.set_Text(textBox1.get_Text()
        + "Current input language is now: "
        + myDefaultLanguage.get_Culture().get_EnglishName());
} //SetNewCurrentLanguage

Vererbungshierarchie

System.Object
  System.Windows.Forms.InputLanguage

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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

InputLanguage-Member
System.Windows.Forms-Namespace