|
JavaTM 2 Platform Standard Edition |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--java.awt.im.InputContext
An InputContext object manages the communication between text editing components and input methods. It dispatches events between them, and forwards requests for information from the input method to the text editing component. It also lets text editing components select input methods by locale.
By default, one InputContext instance is created per Window instance, and this input context is shared by all components within the window's container hierarchy. However, this means that only one text input operation is possible at any one time within a window, and that the text needs to be committed when moving the focus from one text component to another. If this is not desired, text components can create their own input context instances.
Not all platforms and locales support input methods. Where input methods are unavailable, input contexts can still be created and used; the InputContext instance methods return without doing anything (selectLocale returns false).
Constructor Summary | |
protected |
InputContext()
Constructs an InputContext. |
Method Summary | |
void |
dispatchEvent(AWTEvent event)
Dispatches an event to the active input method. |
void |
dispose()
Disposes of the input context and release the resources used by it. |
void |
endComposition()
Ends any input composition that may currently be going on in this context. |
Object |
getInputMethodControlObject()
Returns a control object from the current input method, or null. |
static InputContext |
getInstance()
Returns a new InputContext instance. |
void |
removeNotify(Component client)
Notifies the input context that a client component has been removed from its containment hierarchy, or that input method support has been disabled for the component. |
boolean |
selectInputMethod(Locale locale)
Selects an input method that supports the given locale. |
void |
setCharacterSubsets(Character.Subset[] subsets)
Sets the subsets of the Unicode character set that input methods of this input context should be allowed to input. |
Methods inherited from class java.lang.Object |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait |
Constructor Detail |
protected InputContext()
Method Detail |
public static InputContext getInstance()
public boolean selectInputMethod(Locale locale)
A text editing component may call this method, for example, when the user changes the insertion point, so that the user can immediately continue typing in the language of the surrounding text.
locale
- The desired new locale.public void setCharacterSubsets(Character.Subset[] subsets)
subsets
- The subsets of the Unicode character set from which characters may be inputpublic void dispatchEvent(AWTEvent event)
event
- The eventpublic void removeNotify(Component client)
client
- Client componentpublic void endComposition()
A text editing component may call this in a variety of situations, for example, when the user moves the insertion point within the text (but outside the composed text), or when the component's text is saved to a file or copied to the clipboard.
public void dispose()
public Object getInputMethodControlObject()
|
JavaTM 2 Platform Standard Edition |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |