This documentation is archived and is not being maintained.

InputLanguageChangedEventArgs Class

Provides data for the InputLanguageChanged event.


Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

Public Class InputLanguageChangedEventArgs _
	Inherits EventArgs

The InputLanguageChangedEventArgs type exposes the following members.

Public methodInputLanguageChangedEventArgs(CultureInfo, Byte)Initializes a new instance of the InputLanguageChangedEventArgs class with the specified locale and character set.
Public methodInputLanguageChangedEventArgs(InputLanguage, Byte)Initializes a new instance of the InputLanguageChangedEventArgs class with the specified input language and character set.

Public propertyCharSetGets the character set associated with the new input language.
Public propertyCultureGets the locale of the input language.
Public propertyInputLanguageGets a value indicating the input language.

Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)

You can use the data from the InputLanguageChangedEventArgs to make decisions about whether to change Input Method Editors (IMEs) or swap right-to-left values. You can also change the CurrentCulture of a thread and the CurrentUICulture properties so that different resources get picked up.

An InputLanguageChangedEventArgs identifies the locale and the character set of the new input language.

The InputLanguageChanging event precedes the InputLanguageChanged event.

The following example creates a new Form and attaches an event handler to the InputLanguageChanged event. This event changes the IMEmode when the input language changes to Japanese.

Imports System
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()
      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

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.