< prev index next >
src/java.desktop/share/classes/java/awt/im/InputContext.java
Print this page
*** 126,136 ****
* <p>
* Not all host operating systems provide API to determine the locale of
* the currently selected native input method or keyboard layout, and to
* select a native input method or keyboard layout by locale.
* For host operating systems that don't provide such API,
! * <code>selectInputMethod</code> assumes that native input methods or
* keyboard layouts provided by the host operating system support only the
* system's default locale.
*
* <p>
* A text editing component may call this method, for example, when
--- 126,136 ----
* <p>
* Not all host operating systems provide API to determine the locale of
* the currently selected native input method or keyboard layout, and to
* select a native input method or keyboard layout by locale.
* For host operating systems that don't provide such API,
! * {@code selectInputMethod} assumes that native input methods or
* keyboard layouts provided by the host operating system support only the
* system's default locale.
*
* <p>
* A text editing component may call this method, for example, when
*** 138,148 ****
* immediately continue typing in the language of the surrounding text.
*
* @param locale The desired new locale.
* @return true if the input method or keyboard layout that's active after
* this call supports the desired locale.
! * @exception NullPointerException if <code>locale</code> is null
*/
public boolean selectInputMethod(Locale locale) {
// real implementation is in sun.awt.im.InputContext
return false;
}
--- 138,148 ----
* immediately continue typing in the language of the surrounding text.
*
* @param locale The desired new locale.
* @return true if the input method or keyboard layout that's active after
* this call supports the desired locale.
! * @exception NullPointerException if {@code locale} is null
*/
public boolean selectInputMethod(Locale locale) {
// real implementation is in sun.awt.im.InputContext
return false;
}
*** 156,166 ****
*
* <p>
* Not all host operating systems provide API to determine the locale of
* the currently selected native input method or keyboard layout.
* For host operating systems that don't provide such API,
! * <code>getLocale</code> assumes that the current locale of all native
* input methods or keyboard layouts provided by the host operating system
* is the system's default locale.
*
* @return the current locale of the current input method or keyboard layout
* @since 1.3
--- 156,166 ----
*
* <p>
* Not all host operating systems provide API to determine the locale of
* the currently selected native input method or keyboard layout.
* For host operating systems that don't provide such API,
! * {@code getLocale} assumes that the current locale of all native
* input methods or keyboard layouts provided by the host operating system
* is the system's default locale.
*
* @return the current locale of the current input method or keyboard layout
* @since 1.3
*** 187,197 ****
// real implementation is in sun.awt.im.InputContext
}
/**
* Enables or disables the current input method for composition,
! * depending on the value of the parameter <code>enable</code>.
* <p>
* 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
--- 187,197 ----
// real implementation is in sun.awt.im.InputContext
}
/**
* Enables or disables the current input method for composition,
! * depending on the value of the parameter {@code enable}.
* <p>
* 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
*** 221,232 ****
* Determines whether the current input method is enabled for composition.
* 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.
*
! * @return <code>true</code> if the current input method is enabled for
! * composition; <code>false</code> otherwise
* @throws UnsupportedOperationException if there is no current input
* method available or the current input method does not support
* checking whether it is enabled for composition
* @see #setCompositionEnabled
* @since 1.3
--- 221,232 ----
* Determines whether the current input method is enabled for composition.
* 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.
*
! * @return {@code true} if the current input method is enabled for
! * composition; {@code false} otherwise
* @throws UnsupportedOperationException if there is no current input
* method available or the current input method does not support
* checking whether it is enabled for composition
* @see #setCompositionEnabled
* @since 1.3
*** 240,256 ****
/**
* Asks the current input method to reconvert text from the
* current client component. The input method obtains the text to
* be reconverted from the client component using the
* {@link InputMethodRequests#getSelectedText InputMethodRequests.getSelectedText}
! * method. The other <code>InputMethodRequests</code> methods
* must be prepared to deal with further information requests by
* the input method. The composed and/or committed text will be
* sent to the client component as a sequence of
! * <code>InputMethodEvent</code>s. If the input method cannot
* reconvert the given text, the text is returned as committed
! * text in an <code>InputMethodEvent</code>.
*
* @throws UnsupportedOperationException if there is no current input
* method available or the current input method does not support
* the reconversion operation.
*
--- 240,256 ----
/**
* Asks the current input method to reconvert text from the
* current client component. The input method obtains the text to
* be reconverted from the client component using the
* {@link InputMethodRequests#getSelectedText InputMethodRequests.getSelectedText}
! * method. The other {@code InputMethodRequests} methods
* must be prepared to deal with further information requests by
* the input method. The composed and/or committed text will be
* sent to the client component as a sequence of
! * {@code InputMethodEvent}s. If the input method cannot
* reconvert the given text, the text is returned as committed
! * text in an {@code InputMethodEvent}.
*
* @throws UnsupportedOperationException if there is no current input
* method available or the current input method does not support
* the reconversion operation.
*
*** 263,273 ****
/**
* Dispatches an event to the active input method. Called by AWT.
* If no input method is available, then the event will never be consumed.
*
* @param event The event
! * @exception NullPointerException if <code>event</code> is null
*/
public void dispatchEvent(AWTEvent event) {
// real implementation is in sun.awt.im.InputContext
}
--- 263,273 ----
/**
* Dispatches an event to the active input method. Called by AWT.
* If no input method is available, then the event will never be consumed.
*
* @param event The event
! * @exception NullPointerException if {@code event} is null
*/
public void dispatchEvent(AWTEvent event) {
// real implementation is in sun.awt.im.InputContext
}
*** 280,290 ****
* method. Potentially pending input from input methods
* for this component is discarded.
* If no input methods are available, then this method has no effect.
*
* @param client Client component
! * @exception NullPointerException if <code>client</code> is null
*/
public void removeNotify(Component client) {
// real implementation is in sun.awt.im.InputContext
}
--- 280,290 ----
* method. Potentially pending input from input methods
* for this component is discarded.
* If no input methods are available, then this method has no effect.
*
* @param client Client component
! * @exception NullPointerException if {@code client} is null
*/
public void removeNotify(Component client) {
// real implementation is in sun.awt.im.InputContext
}
< prev index next >