Nested and Inner Type Summary

Modifier and Type	Class and Description
protected class	X11InputMethodBase.IntBuffer IntBuffer is an inner class that manipulates an int array and provides UNIX file io stream-like programming interfaces to access it.

Field Summary

Modifier and Type	Field and Description
protected Component	awtFocussedComponent
protected Container	clientComponentWindow
protected String	committedText
protected StringBuffer	composedText
protected boolean	compositionEnableSupported
protected boolean	disposed
private static Map<TextAttribute, ?>[]	highlightStyles
protected static final int	INITIAL_SIZE
protected boolean	isActive
protected boolean	isLastTemporary
protected boolean	isLastXICActive
private static boolean	isXIMOpened
protected Component	lastXICFocussedComponent
private Locale	locale
protected static final PlatformLogger	log
protected boolean	needResetXIC
private WeakReference<Component>	needResetXICClient
protected transient long	pData
protected X11InputMethodBase.IntBuffer	rawFeedbacks
protected boolean	savedCompositionState
private static final int	XIMHighlight
private static final int	XIMPrimary
private static final int	XIMReverse
private static final int	XIMSecondary
private static final int	XIMTertiary
private static final int	XIMUnderline
protected static final int	XIMVisibleCenter
protected static final int	XIMVisibleMask
protected static final int	XIMVisibleToBackward
protected static final int	XIMVisibleToForward

Constructor Summary

Access	Constructor and Description
public	X11InputMethodBase() Constructs an X11InputMethod instance.

Method Summary

Modifier and Type	Method and Description
public abstract void	activate() Redeclares java.awt.im.spi.InputMethod.activate. Activate input method.
protected abstract void	awtLock() Used to protect preedit data
protected abstract void	awtUnlock()
protected InputMethodHighlight	Returns: Java input method highlight convertVisualFeedbackToHighlight(int feedback) Performs mapping from an XIM visible feedback value to Java IM highlight.
protected abstract boolean	createXIC()
public abstract void	deactivate(boolean isTemporary) Redeclares java.awt.im.spi.InputMethod.deactivate. Deactivate input method.
public void	disableInputMethod() Implements abstract sun.awt.im.InputMethodAdapter.disableInputMethod. Explicitly disable the native IME.
pack-priv void	dispatchCommittedText(String committed text str, long when when) Dispatches committed text from XIM to the awt event queue.
private void	dispatchCommittedText(String str)
pack-priv abstract void	dispatchComposedText(String chgText, int[] chgStyles, int chgOffset, int chgLength, int caretPosition, long when) Updates composed text with XIM preedit information and posts composed text to the awt event queue.
public void	dispatchEvent(AWTEvent event e) Implements java.awt.im.spi.InputMethod.dispatchEvent. Dispatch event to input method.
public final void	dispose() Implements java.awt.im.spi.InputMethod.dispose. Frees all X Window resources associated with this object.
protected abstract void	disposeImpl()
protected native void	disposeXIC()
public void	endComposition() Implements java.awt.im.spi.InputMethod.endComposition. Ends any input composition that may currently be going on in this context.
pack-priv void	flushText() Flushes composed and committed text held in this context.
protected Window	getClientComponentWindow() Returns the Window instance in which the client component is contained.
protected boolean	Returns: the composition state if isCompositionEnabled call is successful. Otherwise, it returns false. getCompositionState() Query and then return the current composition state.
public Object	getControlObject() Implements java.awt.im.spi.InputMethod.getControlObject. Returns null.
public Locale	getLocale() Implements java.awt.im.spi.InputMethod.getLocale. Returns current input locale.
public String	getNativeInputMethodInfo() Implements abstract sun.awt.im.InputMethodAdapter.getNativeInputMethodInfo. Returns a string with information about the current input method server, or null.
protected abstract Container	getParent(Component client)
protected abstract ComponentPeer	getPeer(Component client) Returns peer of the given client component.
public abstract void	hideWindows() Redeclares java.awt.im.spi.InputMethod.hideWindows. Closes or hides all windows opened by this input method instance or its class.
private static native void	initIDs() Initialize JNI field and method IDs for fields that may be accessed from C.
private synchronized boolean	Returns: true if openXIM() is successful or it's already been opened. initXIM() Invokes openIM() that invokes XOpenIM() if it's not opened yet.
public boolean	isCompositionEnabled() Implements java.awt.im.spi.InputMethod.isCompositionEnabled. Determines whether this input method is enabled.
private native boolean	isCompositionEnabledNative()
protected boolean	isDisposed()
public static Map<TextAttribute, ?>	mapInputMethodHighlight(InputMethodHighlight highlight)
protected abstract boolean	openXIM()
protected void	postInputMethodEvent(int id, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo visiblePosition, long when) Creates an input method event from the arguments given and posts it on the AWT event queue.
private void	postInputMethodEvent(int id, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo visiblePosition)
public synchronized void	removeNotify() Implements java.awt.im.spi.InputMethod.removeNotify. Notifies the input method that a client component has been removed from its containment hierarchy, or that input method support has been disabled for the component.
protected abstract void	resetCompositionState() Reset the composition state to the current composition state.
private native String	resetXIC()
protected final void	resetXICifneeded()
protected void	setAWTFocussedComponent(Component component) Overrides sun.awt.im.InputMethodAdapter.setAWTFocussedComponent. Informs the input method adapter about the component that has the AWT focus if it's using the input context owning this adapter instance.
public void	setCharacterSubsets(Character.Subset[] subsets) Implements java.awt.im.spi.InputMethod.setCharacterSubsets. Does nothing - XIM doesn't let you specify which characters you expect.
public abstract void	setCompositionEnabled(boolean enable) Redeclares java.awt.im.spi.InputMethod.setCompositionEnabled. Enables or disables this input method for composition, depending on the value of the parameter `enable`.
protected native boolean	setCompositionEnabledNative(boolean enable)
public void	setInputMethodContext(InputMethodContext context) Implements java.awt.im.spi.InputMethod.setInputMethodContext. Does nothing - this adapter doesn't use the input method context.
public boolean	Returns: the true is returned when specified locale is supported. setLocale(Locale locale to input lang) Implements java.awt.im.spi.InputMethod.setLocale. Set locale to input.
protected abstract void	setXICFocus(ComponentPeer peer, boolean value, boolean active)
protected void	stopListening() Overrides sun.awt.im.InputMethodAdapter.stopListening. Informs the input method adapter not to listen to the native events.
protected native void	turnoffStatusWindow()

Inherited from sun.awt.im.InputMethodAdapter:: getClientComponent haveActiveClient notifyClientWindowChange reconvert supportsBelowTheSpot

Field Detail

awtFocussedComponent	back to summary
protected Component awtFocussedComponent

clientComponentWindow	back to summary
protected Container clientComponentWindow

committedText	back to summary
protected String committedText

composedText	back to summary
protected StringBuffer composedText

compositionEnableSupported	back to summary
protected boolean compositionEnableSupported

disposed	back to summary
protected boolean disposed

highlightStyles	back to summary
private static Map<TextAttribute, ?>[] highlightStyles

INITIAL_SIZE	back to summary
protected static final int INITIAL_SIZE

isActive	back to summary
protected boolean isActive

isLastTemporary	back to summary
protected boolean isLastTemporary

isLastXICActive	back to summary
protected boolean isLastXICActive

isXIMOpened	back to summary
private static boolean isXIMOpened

lastXICFocussedComponent	back to summary
protected Component lastXICFocussedComponent

locale	back to summary
private Locale locale

log	back to summary
protected static final PlatformLogger log

needResetXIC	back to summary
protected boolean needResetXIC

needResetXICClient	back to summary
private WeakReference<Component> needResetXICClient

pData	back to summary
protected transient long pData

rawFeedbacks	back to summary
protected X11InputMethodBase.IntBuffer rawFeedbacks

savedCompositionState	back to summary
protected boolean savedCompositionState

XIMHighlight	back to summary
private static final int XIMHighlight

XIMPrimary	back to summary
private static final int XIMPrimary

XIMReverse	back to summary
private static final int XIMReverse

XIMSecondary	back to summary
private static final int XIMSecondary

XIMTertiary	back to summary
private static final int XIMTertiary

XIMUnderline	back to summary
private static final int XIMUnderline

XIMVisibleCenter	back to summary
protected static final int XIMVisibleCenter

XIMVisibleMask	back to summary
protected static final int XIMVisibleMask

XIMVisibleToBackward	back to summary
protected static final int XIMVisibleToBackward

XIMVisibleToForward	back to summary
protected static final int XIMVisibleToForward

Constructor Detail

X11InputMethodBase	back to summary
public X11InputMethodBase() throws AWTException Constructs an X11InputMethod instance. It initializes the XIM environment if it's not done yet. Exceptions AWTException: if XOpenIM() failed.

X11InputMethodBase

back to summary

public X11InputMethodBase() throws AWTException

Constructs an X11InputMethod instance. It initializes the XIM environment if it's not done yet.

Exceptions

AWTException:: if XOpenIM() failed.

Method Detail

activate	back to summary
public abstract void activate() Redeclares java.awt.im.spi.InputMethod.activate. Activate input method. Annotations @Override

activate

back to summary

public abstract void activate()

Redeclares java.awt.im.spi.InputMethod.activate.

Activate input method.

Annotations

@Override

awtLock	back to summary
protected abstract void awtLock() Used to protect preedit data

awtUnlock	back to summary
protected abstract void awtUnlock()

convertVisualFeedbackToHighlight	back to summary
protected InputMethodHighlight convertVisualFeedbackToHighlight(int feedback) Performs mapping from an XIM visible feedback value to Java IM highlight. Returns:InputMethodHighlight Java input method highlight

convertVisualFeedbackToHighlight

back to summary

protected InputMethodHighlight convertVisualFeedbackToHighlight(int feedback)

Performs mapping from an XIM visible feedback value to Java IM highlight.

Returns:InputMethodHighlight: Java input method highlight

createXIC	back to summary
protected abstract boolean createXIC()

deactivate	back to summary
public abstract void deactivate(boolean isTemporary) Redeclares java.awt.im.spi.InputMethod.deactivate. Deactivate input method. Annotations @Override

deactivate

back to summary

public abstract void deactivate(boolean isTemporary)

Redeclares java.awt.im.spi.InputMethod.deactivate.

Deactivate input method.

Annotations

@Override

disableInputMethod	back to summary
public void disableInputMethod() Implements abstract sun.awt.im.InputMethodAdapter.disableInputMethod. Explicitly disable the native IME. Native IME is not disabled when deactivate is called. Annotations @Override

disableInputMethod

back to summary

public void disableInputMethod()

Implements abstract sun.awt.im.InputMethodAdapter.disableInputMethod.

Explicitly disable the native IME. Native IME is not disabled when deactivate is called.

Annotations

@Override

dispatchCommittedText	back to summary
pack-priv void dispatchCommittedText(String str, long when) Dispatches committed text from XIM to the awt event queue. This method is invoked from the event handler in canvas.c in the AWT Toolkit thread context and thus inside the AWT Lock. Parameters str:String committed text when:long when

dispatchCommittedText

back to summary

pack-priv void dispatchCommittedText(String str, long when)

Dispatches committed text from XIM to the awt event queue. This method is invoked from the event handler in canvas.c in the AWT Toolkit thread context and thus inside the AWT Lock.

Parameters

str:String: committed text
when:long: when

dispatchCommittedText	back to summary
private void dispatchCommittedText(String str)

dispatchComposedText	back to summary
pack-priv abstract void dispatchComposedText(String chgText, int[] chgStyles, int chgOffset, int chgLength, int caretPosition, long when) Updates composed text with XIM preedit information and posts composed text to the awt event queue. The args of this method correspond to the XIM preedit callback information. The XIM highlight attributes are translated via fixed mapping (i.e., independent from any underlying input method engine). This method is invoked in the AWT Toolkit (X event loop) thread context and thus inside the AWT Lock.

dispatchComposedText

back to summary

pack-priv abstract void dispatchComposedText(String chgText, int[] chgStyles, int chgOffset, int chgLength, int caretPosition, long when)

Updates composed text with XIM preedit information and posts composed text to the awt event queue. The args of this method correspond to the XIM preedit callback information. The XIM highlight attributes are translated via fixed mapping (i.e., independent from any underlying input method engine). This method is invoked in the AWT Toolkit (X event loop) thread context and thus inside the AWT Lock.

dispatchEvent	back to summary
public void dispatchEvent(AWTEvent e) Implements java.awt.im.spi.InputMethod.dispatchEvent. Dispatch event to input method. InputContext dispatch event with this method. Input method set consume flag if event is consumed in input method. Parameters e:AWTEvent event Annotations @Override

dispatchEvent

back to summary

public void dispatchEvent(AWTEvent e)

Implements java.awt.im.spi.InputMethod.dispatchEvent.

Dispatch event to input method. InputContext dispatch event with this method. Input method set consume flag if event is consumed in input method.

Parameters

e:AWTEvent: event

Annotations

@Override

dispose back to summary

dispose	back to summary
public final void dispose() Implements java.awt.im.spi.InputMethod.dispose. Frees all X Window resources associated with this object. Annotations @Override See Also `java.awt.im.spi.InputMethod#dispose`

public final void dispose()

Implements java.awt.im.spi.InputMethod.dispose.

Frees all X Window resources associated with this object.

Annotations

@Override

See Also

java.awt.im.spi.InputMethod#dispose

disposeImpl	back to summary
protected abstract void disposeImpl()

disposeXIC	back to summary
protected native void disposeXIC()

endComposition	back to summary
public void endComposition() Implements java.awt.im.spi.InputMethod.endComposition. Ends any input composition that may currently be going on in this context. Depending on the platform and possibly user preferences, this may commit or delete uncommitted text. Any changes to the text are communicated to the active component using an input method event. 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. Annotations @Override

endComposition

back to summary

public void endComposition()

Implements java.awt.im.spi.InputMethod.endComposition.

Ends any input composition that may currently be going on in this context. Depending on the platform and possibly user preferences, this may commit or delete uncommitted text. Any changes to the text are communicated to the active component using an input method event.

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.

Annotations

@Override

flushText	back to summary
pack-priv void flushText() Flushes composed and committed text held in this context. This method is invoked in the AWT Toolkit (X event loop) thread context and thus inside the AWT Lock.

getClientComponentWindow	back to summary
protected Window getClientComponentWindow() Returns the Window instance in which the client component is contained. If not found, null is returned. (IS THIS POSSIBLE?)

getCompositionState

back to summary

protected boolean getCompositionState()

Query and then return the current composition state.

Returns:boolean: the composition state if isCompositionEnabled call is successful. Otherwise, it returns false.

getControlObject back to summary

public Object getControlObject()

Implements java.awt.im.spi.InputMethod.getControlObject.

Returns null.

Annotations

@Override

getLocale

back to summary

public Locale getLocale()

Implements java.awt.im.spi.InputMethod.getLocale.

Returns current input locale.

Annotations

@Override

getNativeInputMethodInfo

back to summary

public String getNativeInputMethodInfo()

Implements abstract sun.awt.im.InputMethodAdapter.getNativeInputMethodInfo.

Returns a string with information about the current input method server, or null. On both Linux & SunOS, the value of environment variable XMODIFIERS is returned if set. Otherwise, on SunOS, $HOME/.dtprofile will be parsed to find out the language service engine (atok or wnn) since there is no API in Xlib which returns the information of native IM server or language service and we want to try our best to return as much information as possible.

Note

This method could return null on Linux if XMODIFIERS is not set properly or if any IOException is thrown. See man page of XSetLocaleModifiers(3X11) for the usgae of XMODIFIERS, atok12setup(1) and wnn6setup(1) for the information written to $HOME/.dtprofile when you run these two commands.

Annotations

@Override

getParent	back to summary
protected abstract Container getParent(Component client)

getPeer	back to summary
protected abstract ComponentPeer getPeer(Component client) Returns peer of the given client component. If the given client component doesn't have peer, peer of the native container of the client is returned.

hideWindows back to summary

public abstract void hideWindows()

Redeclares java.awt.im.spi.InputMethod.hideWindows.

Doc from java.awt.im.spi.InputMethod.hideWindows.

Closes or hides all windows opened by this input method instance or its class.

This method is called

before calling activate on an instance of a different input method class,
before calling dispose on this input method.

The method is only called when the input method is inactive.

Annotations

@Override

initIDs	back to summary
private static native void initIDs() Initialize JNI field and method IDs for fields that may be accessed from C.

initXIM

back to summary

private synchronized boolean initXIM()

Invokes openIM() that invokes XOpenIM() if it's not opened yet.

Returns:boolean: true if openXIM() is successful or it's already been opened.

isCompositionEnabled back to summary

public boolean isCompositionEnabled()

Implements java.awt.im.spi.InputMethod.isCompositionEnabled.

Doc from java.awt.im.spi.InputMethod.isCompositionEnabled.

Determines whether this input method is enabled. An input method that is enabled for composition interprets incoming events for both composition and control purposes, while a disabled input method does not interpret events for composition.

This method is called

by InputContext.isCompositionEnabled and
when switching from this input method to a different one using the user interface or InputContext.selectInputMethod.

Annotations

@Override

isCompositionEnabledNative	back to summary
private native boolean isCompositionEnabledNative()

isDisposed	back to summary
protected boolean isDisposed()

mapInputMethodHighlight	back to summary
public static Map<TextAttribute, ?> mapInputMethodHighlight(InputMethodHighlight highlight) See Also `java.awt.Toolkit#mapInputMethodHighlight`

openXIM	back to summary
protected abstract boolean openXIM()

postInputMethodEvent back to summary

protected void postInputMethodEvent(int id, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo visiblePosition, long when)

Creates an input method event from the arguments given and posts it on the AWT event queue. For arguments, see InputMethodEvent. Called by input method.

See Also: java.awt.event.InputMethodEvent#InputMethodEvent

postInputMethodEvent	back to summary
private void postInputMethodEvent(int id, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo visiblePosition)

removeNotify back to summary

public synchronized void removeNotify()

Implements java.awt.im.spi.InputMethod.removeNotify.

Doc from java.awt.im.spi.InputMethod.removeNotify.

Notifies the input method that a client component has been removed from its containment hierarchy, or that input method support has been disabled for the component.

This method is called by InputContext.removeNotify.

The method is only called when the input method is inactive.

Annotations

@Override

resetCompositionState	back to summary
protected abstract void resetCompositionState() Reset the composition state to the current composition state.

resetXIC	back to summary
private native String resetXIC()

resetXICifneeded	back to summary
protected final void resetXICifneeded()

setAWTFocussedComponent back to summary

protected void setAWTFocussedComponent(Component component)

Overrides sun.awt.im.InputMethodAdapter.setAWTFocussedComponent.

Doc from sun.awt.im.InputMethodAdapter.setAWTFocussedComponent.

Informs the input method adapter about the component that has the AWT focus if it's using the input context owning this adapter instance.

Annotations

@Override

setCharacterSubsets back to summary

public void setCharacterSubsets(Character.Subset[] subsets)

Implements java.awt.im.spi.InputMethod.setCharacterSubsets.

Does nothing - XIM doesn't let you specify which characters you expect.

Annotations

@Override

setCompositionEnabled back to summary

public abstract void setCompositionEnabled(boolean enable)

Redeclares java.awt.im.spi.InputMethod.setCompositionEnabled.

Doc from java.awt.im.spi.InputMethod.setCompositionEnabled.

Enables or disables this input method for composition, depending on the value of the parameter enable.

An input method that is enabled for composition interprets incoming events for both composition and control purposes, while a disabled input method does not interpret events for composition. Note however that events are passed on to the input method regardless whether it is enabled or not, and that an input method that is disabled for composition may still interpret events for control purposes, including to enable or disable itself for composition.

For input methods provided by host operating systems, it is not always possible to determine whether this operation is supported. For example, an input method may enable composition only for some locales, and do nothing for other locales. For such input methods, it is possible that this method does not throw UnsupportedOperationException, but also does not affect whether composition is enabled.

This method is called

by InputContext.setCompositionEnabled,
when switching to this input method from a different one using the user interface or InputContext.selectInputMethod, if the previously selected input method's isCompositionEnabled method returns without throwing an exception.

Annotations

@Override

setCompositionEnabledNative	back to summary
protected native boolean setCompositionEnabledNative(boolean enable)

setInputMethodContext back to summary

public void setInputMethodContext(InputMethodContext context)

Implements java.awt.im.spi.InputMethod.setInputMethodContext.

Does nothing - this adapter doesn't use the input method context.

Annotations

@Override

setLocale

back to summary

public boolean setLocale(Locale lang)

Implements java.awt.im.spi.InputMethod.setLocale.

Set locale to input. If input method doesn't support specified locale, false will be returned and its behavior is not changed.

Parameters

lang:Locale: locale to input

Returns:boolean

the true is returned when specified locale is supported.

Annotations

@Override

setXICFocus	back to summary
protected abstract void setXICFocus(ComponentPeer peer, boolean value, boolean active)

stopListening back to summary

protected void stopListening()

Overrides sun.awt.im.InputMethodAdapter.stopListening.

Doc from sun.awt.im.InputMethodAdapter.stopListening.

Informs the input method adapter not to listen to the native events.

Annotations

@Override

turnoffStatusWindow	back to summary
protected native void turnoffStatusWindow()

sun.awt back to summary

protected final Class X11InputMethodBase.IntBuffer

Class Inheritance

extends Object

java.lang.Object
sun.awt.X11InputMethodBase.IntBuffer

IntBuffer is an inner class that manipulates an int array and provides UNIX file io stream-like programming interfaces to access it. (An alternative would be to use ArrayList which may be too expensive for the work.)

Field Summary

Modifier and Type	Field and Description
private int	index
private int[]	intArray
private int	size

Constructor Summary

Access	Constructor and Description
pack-priv	IntBuffer(int initialCapacity)

Method Summary

Modifier and Type	Method and Description
pack-priv int	getNext()
pack-priv int	getOffset()
pack-priv void	insert(int offset, int[] values)
pack-priv void	remove(int offset, int length)
pack-priv void	removeAll()
pack-priv void	replace(int offset, int[] values)
pack-priv void	rewind()
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.
pack-priv void	unget()

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll wait wait wait

Field Detail

index	back to summary
private int index

intArray	back to summary
private int[] intArray

size	back to summary
private int size

Constructor Detail

IntBuffer	back to summary
pack-priv IntBuffer(int initialCapacity)

Method Detail

getNext	back to summary
pack-priv int getNext()

getOffset	back to summary
pack-priv int getOffset()

insert	back to summary
pack-priv void insert(int offset, int[] values)

remove	back to summary
pack-priv void remove(int offset, int length)

removeAll	back to summary
pack-priv void removeAll()

replace	back to summary
pack-priv void replace(int offset, int[] values)

rewind	back to summary
pack-priv void rewind()

toString back to summary

public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object. Satisfying this method's contract implies a non-null result must be returned.

Annotations

@Override

unget	back to summary
pack-priv void unget()

public abstract Class X11InputMethodBase

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

protected final Class X11InputMethodBase.IntBuffer

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail