am f2724463: Merge "Improve the API document for supportsSwitchingToNextInputMethod" into klp-dev

* commit 'f272446372b865e315240bce50853769d77fa939':
  Improve the API document for supportsSwitchingToNextInputMethod
This commit is contained in:
satok
2013-09-01 22:52:59 -07:00
committed by Android Git Automerger
2 changed files with 14 additions and 4 deletions

View File

@@ -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 * Returns true if the current IME needs to offer the users ways to switch to a next input
* method. When the user triggers it, the IME has to call {@link #switchToNextInputMethod} to * method (e.g. a globe key.).
* switch to a next input method which is selected by the system. * 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, * @param imeToken Supplies the identifying token given to an input method when it was started,
* which allows it to perform this operation on itself. * which allows it to perform this operation on itself.
*/ */

View File

@@ -2379,7 +2379,13 @@
method should be considered an option as the default. --> method should be considered an option as the default. -->
<attr name="isDefault" format="boolean" /> <attr name="isDefault" format="boolean" />
<!-- Set to true if this input method supports ways to switch to <!-- 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" /> <attr name="supportsSwitchingToNextInputMethod" format="boolean" />
</declare-styleable> </declare-styleable>