diff options
| author | satok <satok@google.com> | 2013-08-26 14:17:18 +0900 |
|---|---|---|
| committer | satok <satok@google.com> | 2013-08-27 11:08:24 +0900 |
| commit | 15ab6b016c0cabda502c97d248b45f5c617f0428 (patch) | |
| tree | ccfc456134e780b8bd9c556988bb8fbeb247a38d /core | |
| parent | b240578f0333f5b35472cb11d6d7b5bb1da431cc (diff) | |
| download | frameworks_base-15ab6b016c0cabda502c97d248b45f5c617f0428.zip frameworks_base-15ab6b016c0cabda502c97d248b45f5c617f0428.tar.gz frameworks_base-15ab6b016c0cabda502c97d248b45f5c617f0428.tar.bz2 | |
Improve the API document for supportsSwitchingToNextInputMethod
Bug: 10461455
Change-Id: I0d3c5d3cd40f7ad057970fddd141bfd838e246f4
Diffstat (limited to 'core')
| -rw-r--r-- | core/java/android/view/inputmethod/InputMethodManager.java | 10 | ||||
| -rw-r--r-- | core/res/res/values/attrs.xml | 8 |
2 files changed, 14 insertions, 4 deletions
diff --git a/core/java/android/view/inputmethod/InputMethodManager.java b/core/java/android/view/inputmethod/InputMethodManager.java index f97e3dd..54b87de 100644 --- a/core/java/android/view/inputmethod/InputMethodManager.java +++ b/core/java/android/view/inputmethod/InputMethodManager.java @@ -1876,9 +1876,13 @@ public final class InputMethodManager { } /** - * Returns true if the current IME needs to offer the users a way to switch to a next input - * method. When the user triggers it, the IME has to call {@link #switchToNextInputMethod} to - * switch to a next input method which is selected by the system. + * Returns true if the current IME needs to offer the users ways to switch to a next input + * method (e.g. a globe key.). + * When an IME sets supportsSwitchingToNextInputMethod and this method returns true, + * the IME has to offer ways to to invoke {@link #switchToNextInputMethod} accordingly. + * <p> Note that the system determines the most appropriate next input method + * and subtype in order to provide the consistent user experience in switching + * between IMEs and subtypes. * @param imeToken Supplies the identifying token given to an input method when it was started, * which allows it to perform this operation on itself. */ diff --git a/core/res/res/values/attrs.xml b/core/res/res/values/attrs.xml index 50ea08b..c239b02 100644 --- a/core/res/res/values/attrs.xml +++ b/core/res/res/values/attrs.xml @@ -2379,7 +2379,13 @@ method should be considered an option as the default. --> <attr name="isDefault" format="boolean" /> <!-- Set to true if this input method supports ways to switch to - a next input method (e.g. a globe key.). --> + a next input method (e.g. a globe key.). When this is true and + InputMethodManager#shouldOfferSwitchingToNextInputMethod() returns true, + the IME has to offer ways to to invoke InputMethodManager#switchToNextInputMethod() + accordingly. + <p> Note that the system determines the most appropriate next input method + and subtype in order to provide the consistent user experience in switching + between IMEs and subtypes. --> <attr name="supportsSwitchingToNextInputMethod" format="boolean" /> </declare-styleable> |