About com.ms.util.InputMethod

The com.ms.util.InputMethod package provides Java classes and interfaces that support Input Method messaging and access to native system Input Method Editors (IMEs).

The Microsoft® Input Method Editor for Java APIs are designed to work with both Java and native system IMEs on any system where the Microsoft Win32 VM for Java is installed.

Level 2 IME Support

Currently, only level 2 IME support, where the user can type in text via a composition window, is provided for AFC components (components derived from com.ms.ui.UIComponent, or that implement the IUIComponent interface).

Level 3 IME Support

Level 3 IME support, where an IME is completely managed by an application, exists for components derived from java.awt.Component. The architecture of the com.ms.util.InputMethod package allows IMEs to work with components that are originally not IME-aware.

Input Method Editors generate InputMethodMessage-derived messages (such as IMECompositionMessage and IMENotifyMessage) when states change in the IME. These messages are passed to the InputMethodCallback.handleIMEMessage method. If the currently focused (AWT-derived) component implements the InputMethodMessageListener interface, these IME messages are passed to that component. The component can render its own custom IME user interface (handleIMEMessage returns true), or pass the message on to the InputMethodListener (handleIMEMessage returns false), which can then draw a default IME user interface.

The JavaIME accelerator key switching behavior is as follows: Ctrl+Alt will switch from JavaIME1, JavaIME2, ..., no IME, and back to JavaIME1, IME2, and so on.

Classes

Class IMECompositionMessage

This class implements Input Method (IME) Composition messages.

Class IMENotifyMessage

This class provides message objects that notify an Input Method Editor (IME) object to perform an action with one of the various windows associated with it.

Class InputMethodMessage

This class provides a base from which input method editor (IME) message classes can be derived.

Interfaces

Interface InputManagerListener

This interface receives messages from a system input and distributes those messages to designated Input Method Editors (IMEs) and other Components.

Interface InputMethodCallback

This interface enables InputMethodListener objects to return composed characters and Input Method Editor (IME) messages.

Interface InputMethodListener

This class must be implemented by Input Method Editors (IMEs) to be used with Java applications.

Interface InputMethodMessageListener

This interface is implemented by classes derived from java.awt.Component to handle Input Method Editor (IME) messages.

Hierarchy

Object
  |
  +--InputMethodMessage
     |
     +--IMECompositionMessage
     |
     +--IMENotifyMessage

InputManagerListener
InputMethodCallback
InputMethodListener
InputMethodMessageListener