# Print output for @column tags ?> InputMethodInfo - Android SDK | Android Developers

Most visited

Recently visited

InputMethodInfo

public final class InputMethodInfo
extends Object implements Parcelable

java.lang.Object
   ↳ android.view.inputmethod.InputMethodInfo


This class is used to specify meta information of an input method.

It should be defined in an XML resource file with an <input-method> element. For more information, see the guide to Creating an Input Method.

See also:

Summary

XML attributes

android:configChanges Specify one or more configuration changes that the IME will handle itself. 
android:isDefault Set to true in all of the configurations for which this input method should be considered an option as the default. 
android:settingsActivity Component name of an activity that allows the user to modify the settings for this service. 
android:showInInputMethodPicker Specifies whether the IME wants to be shown in the Input Method picker. 
android:supportsInlineSuggestions Specifies whether the IME supports showing inline suggestions. 
android:supportsSwitchingToNextInputMethod Set to true if this input method supports ways to switch to a next input method (for example, a globe key.). 
android:suppressesSpellChecker Specifies whether the IME suppresses system spell checker. 

Inherited constants

Fields

public static final Creator<InputMethodInfo> CREATOR

Used to make this class parcelable.

Public constructors

InputMethodInfo(Context context, ResolveInfo service)

Constructor.

InputMethodInfo(String packageName, String className, CharSequence label, String settingsActivity)

Temporary API for creating a built-in input method for test.

Public methods

int describeContents()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation.

void dump(Printer pw, String prefix)
boolean equals(Object o)

Used to test whether the given parameter object is an InputMethodInfo and its Id is the same to this one.

ComponentName getComponent()

Return the component of the service that implements this input method.

int getConfigChanges()

Returns the bit mask of kinds of configuration changes that this IME can handle itself (without being restarted by the system).

String getId()

Return a unique ID for this input method.

int getIsDefaultResourceId()

Return the resource identifier of a resource inside of this input method's .apk that determines whether it should be considered a default input method for the system.

String getPackageName()

Return the .apk package that implements this input method.

ServiceInfo getServiceInfo()

Return the raw information about the Service implementing this input method.

String getServiceName()

Return the class name of the service component that implements this input method.

String getSettingsActivity()

Return the class name of an activity that provides a settings UI for the input method.

InputMethodSubtype getSubtypeAt(int index)

Return the Input Method's subtype at the specified index.

int getSubtypeCount()

Return the count of the subtypes of Input Method.

int hashCode()

Returns a hash code value for the object.

Drawable loadIcon(PackageManager pm)

Load the user-displayed icon for this input method.

CharSequence loadLabel(PackageManager pm)

Load the user-displayed label for this input method.

boolean shouldShowInInputMethodPicker()

Returns true if this input method should be shown in menus for selecting an Input Method, such as the system Input Method Picker.

boolean suppressesSpellChecker()

Return true if this input method suppresses spell checker.

String toString()

Returns a string representation of the object.

void writeToParcel(Parcel dest, int flags)

Used to package this object into a Parcel.

Inherited methods

XML attributes

android:configChanges

Specify one or more configuration changes that the IME will handle itself. If not specified, the IME will be restarted if any of these configuration changes happen in the system. Otherwise, the IME will remain running and its InputMethodService.onConfigurationChanged(Configuration) method is called with the new configuration.

Note that all of these configuration changes can impact the resource values seen by the application, so you will generally need to re-retrieve all resources (including view layouts, drawables, etc) to correctly handle any configuration change.

Must be one or more (separated by '|') of the following constant values.

ConstantValueDescription
colorMode4000The color mode of the screen has changed (color gamut or dynamic range).
density1000The display density has changed. This might be caused by the user specifying a different display scale, or it might be caused by a different display being activated.
fontScale40000000The font scaling factor has changed, that is the user has selected a new global font size.
fontWeightAdjustment10000000The font weight adjustment value has changed. Used to reflect the user increasing font weight.
keyboard10The keyboard type has changed, for example the user has plugged in an external keyboard.
keyboardHidden20The keyboard or navigation accessibility has changed, for example the user has slid the keyboard out to expose it. Note that despite its name, this applied to any accessibility: keyboard or navigation.
layoutDirection2000The layout direction has changed. For example going from LTR to RTL.
locale4The locale has changed, that is the user has selected a new language that text should be displayed in.
mcc1The IMSI MCC has changed, that is a SIM has been detected and updated the Mobile Country Code. By default from Android O, we don't recreate the activity even the app doesn't specify mcc in configChanges. If the app wants to recreate the activity, specify mcc in recreateOnConfigChanges.
mnc2The IMSI MNC has changed, that is a SIM has been detected and updated the Mobile Network Code. By default from Android O, we don't recreate the activity even the app doesn't specify mnc in configChanges. If the app wants to recreate the acvitity, specify mnc in recreateOnConfigChanges.
navigation40The navigation type has changed. Should never normally happen.
orientation80The screen orientation has changed, that is the user has rotated the device.
screenLayout100The screen layout has changed. This might be caused by a different display being activated.
screenSize400The current available screen size has changed. If applications don't target at least Build.VERSION_CODES.HONEYCOMB_MR2 then the activity will always handle this itself (the change will not result in a restart). This represents a change in the currently available size, so will change when the user switches between landscape and portrait.
smallestScreenSize800The physical screen size has changed. If applications don't target at least Build.VERSION_CODES.HONEYCOMB_MR2 then the activity will always handle this itself (the change will not result in a restart). This represents a change in size regardless of orientation, so will only change when the actual physical screen size has changed such as switching to an external display.
touchscreen8The touchscreen has changed. Should never normally happen.
uiMode200The global user interface mode has changed. For example, going in or out of car mode, night mode changing, etc.

Related methods:

android:isDefault

Set to true in all of the configurations for which this input method should be considered an option as the default.

May be a boolean value, such as "true" or "false".

android:settingsActivity

Component name of an activity that allows the user to modify the settings for this service.

May be a string value, using '\\;' to escape characters such as '\\n' or '\\uxxxx' for a unicode character;

android:showInInputMethodPicker

Specifies whether the IME wants to be shown in the Input Method picker. Defaults to true. Set this to false if the IME is intended to be accessed programmatically.

Note: This functions as a hint to the system, which may choose to ignore this preference in certain situations or in future releases.

May be a boolean value, such as "true" or "false".

android:supportsInlineSuggestions

Specifies whether the IME supports showing inline suggestions.

May be a boolean value, such as "true" or "false".

android:supportsSwitchingToNextInputMethod

Set to true if this input method supports ways to switch to a next input method (for example, a globe key.). When this is true and InputMethodManager#shouldOfferSwitchingToNextInputMethod() returns true, the IME has to offer ways to invoke InputMethodManager#switchToNextInputMethod() accordingly.

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.

May be a boolean value, such as "true" or "false".

android:suppressesSpellChecker

Specifies whether the IME suppresses system spell checker. The default value is false. If an IME sets this attribute to true, the system spell checker will be disabled while the IME has an active input session.

May be a boolean value, such as "true" or "false".

Fields

CREATOR

public static final Creator<InputMethodInfo> CREATOR

Used to make this class parcelable.

Public constructors

InputMethodInfo

public InputMethodInfo (Context context, 
                ResolveInfo service)

Constructor.

Parameters
context Context: The Context in which we are parsing the input method.

service ResolveInfo: The ResolveInfo returned from the package manager about this input method's component.

Throws
IOException
XmlPullParserException

InputMethodInfo

public InputMethodInfo (String packageName, 
                String className, 
                CharSequence label, 
                String settingsActivity)

Temporary API for creating a built-in input method for test.

Parameters
packageName String

className String

label CharSequence

settingsActivity String

Public methods

describeContents

public int describeContents ()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. For example, if the object will include a file descriptor in the output of writeToParcel(android.os.Parcel, int), the return value of this method must include the CONTENTS_FILE_DESCRIPTOR bit.

Returns
int a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either 0 or CONTENTS_FILE_DESCRIPTOR

dump

public void dump (Printer pw, 
                String prefix)

Parameters
pw Printer

prefix String

equals

public boolean equals (Object o)

Used to test whether the given parameter object is an InputMethodInfo and its Id is the same to this one.

Parameters
o Object: This value may be null.

Returns
boolean true if the given parameter object is an InputMethodInfo and its Id is the same to this one.

getComponent

public ComponentName getComponent ()

Return the component of the service that implements this input method.

Returns
ComponentName

getConfigChanges

public int getConfigChanges ()

Returns the bit mask of kinds of configuration changes that this IME can handle itself (without being restarted by the system).

Related XML Attributes:

Returns
int Value is either 0 or a combination of ActivityInfo.CONFIG_MCC, ActivityInfo.CONFIG_MNC, ActivityInfo.CONFIG_LOCALE, ActivityInfo.CONFIG_TOUCHSCREEN, ActivityInfo.CONFIG_KEYBOARD, ActivityInfo.CONFIG_KEYBOARD_HIDDEN, ActivityInfo.CONFIG_NAVIGATION, ActivityInfo.CONFIG_ORIENTATION, ActivityInfo.CONFIG_SCREEN_LAYOUT, ActivityInfo.CONFIG_UI_MODE, ActivityInfo.CONFIG_SCREEN_SIZE, ActivityInfo.CONFIG_SMALLEST_SCREEN_SIZE, ActivityInfo.CONFIG_DENSITY, ActivityInfo.CONFIG_LAYOUT_DIRECTION, ActivityInfo.CONFIG_COLOR_MODE, and ActivityInfo.CONFIG_FONT_SCALE

getId

public String getId ()

Return a unique ID for this input method. The ID is generated from the package and class name implementing the method.

Returns
String

getIsDefaultResourceId

public int getIsDefaultResourceId ()

Return the resource identifier of a resource inside of this input method's .apk that determines whether it should be considered a default input method for the system.

Returns
int

getPackageName

public String getPackageName ()

Return the .apk package that implements this input method.

Returns
String

getServiceInfo

public ServiceInfo getServiceInfo ()

Return the raw information about the Service implementing this input method. Do not modify the returned object.

Returns
ServiceInfo

getServiceName

public String getServiceName ()

Return the class name of the service component that implements this input method.

Returns
String

getSettingsActivity

public String getSettingsActivity ()

Return the class name of an activity that provides a settings UI for the input method. You can launch this activity be starting it with an Intent whose action is MAIN and with an explicit ComponentName composed of getPackageName() and the class name returned here.

A null will be returned if there is no settings activity associated with the input method.

Returns
String

getSubtypeAt

public InputMethodSubtype getSubtypeAt (int index)

Return the Input Method's subtype at the specified index.

Parameters
index int: the index of the subtype to return.

Returns
InputMethodSubtype

getSubtypeCount

public int getSubtypeCount ()

Return the count of the subtypes of Input Method.

Returns
int

hashCode

public int hashCode ()

Returns a hash code value for the object. This method is supported for the benefit of hash tables such as those provided by HashMap.

The general contract of hashCode is:

  • Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
  • If two objects are equal according to the equals(Object) method, then calling the hashCode method on each of the two objects must produce the same integer result.
  • It is not required that if two objects are unequal according to the equals(java.lang.Object) method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

As much as is reasonably practical, the hashCode method defined by class Object does return distinct integers for distinct objects. (This is typically implemented by converting the internal address of the object into an integer, but this implementation technique is not required by the Java™ programming language.)

Returns
int a hash code value for this object.

loadIcon

public Drawable loadIcon (PackageManager pm)

Load the user-displayed icon for this input method.

Parameters
pm PackageManager: Supply a PackageManager used to load the input method's resources.

Returns
Drawable

loadLabel

public CharSequence loadLabel (PackageManager pm)

Load the user-displayed label for this input method.

Parameters
pm PackageManager: Supply a PackageManager used to load the input method's resources.

Returns
CharSequence

shouldShowInInputMethodPicker

public boolean shouldShowInInputMethodPicker ()

Returns true if this input method should be shown in menus for selecting an Input Method, such as the system Input Method Picker. This is false if the IME is intended to be accessed programmatically.

Returns
boolean

suppressesSpellChecker

public boolean suppressesSpellChecker ()

Return true if this input method suppresses spell checker.

Returns
boolean

toString

public String toString ()

Returns a string representation of the object. In general, the toString method returns a string that "textually represents" this object. The result should be a concise but informative representation that is easy for a person to read. It is recommended that all subclasses override this method.

The toString method for class Object returns a string consisting of the name of the class of which the object is an instance, the at-sign character `@', and the unsigned hexadecimal representation of the hash code of the object. In other words, this method returns a string equal to the value of:

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

Returns
String a string representation of the object.

writeToParcel

public void writeToParcel (Parcel dest, 
                int flags)

Used to package this object into a Parcel.

Parameters
dest Parcel: The Parcel to be written.

flags int: The flags used for parceling.