InputType
interface InputType
android.text.InputType |
Bit definitions for an integer defining the basic content type of text held in an Editable
object. Supported classes may be combined with variations and flags to indicate desired behaviors.
Examples
- A password field with the password visible to the user:
- inputType = TYPE_CLASS_TEXT | TYPE_TEXT_VARIATION_VISIBLE_PASSWORD
- A multi-line postal address with automatic capitalization:
- inputType = TYPE_CLASS_TEXT | TYPE_TEXT_VARIATION_POSTAL_ADDRESS | TYPE_TEXT_FLAG_MULTI_LINE
- A time field:
- inputType = TYPE_CLASS_DATETIME | TYPE_DATETIME_VARIATION_TIME
Summary
Constants | |
---|---|
static Int |
Class for dates and times. |
static Int |
Class for numeric text. |
static Int |
Class for a phone number. |
static Int |
Class for normal text. |
static Int |
Default variation of |
static Int |
Default variation of |
static Int |
Default variation of |
static Int |
Mask of bits that determine the overall class of text being given. |
static Int |
Mask of bits that provide addition bit flags of options. |
static Int |
Mask of bits that determine the variation of the base content class. |
static Int |
Special content type for when no explicit type has been specified. |
static Int |
Flag of |
static Int |
Flag of |
static Int |
Default variation of |
static Int |
Variation of |
static Int |
Flag for |
static Int |
Flag for |
static Int |
Flag for |
static Int |
Flag for |
static Int |
Flag for |
static Int |
Flag for |
static Int |
Flag for |
static Int |
Flag for |
static Int |
Flag for |
static Int |
Variation of |
static Int |
Variation of |
static Int |
Variation of |
static Int |
Variation of |
static Int |
Default variation of |
static Int |
Variation of |
static Int |
Variation of |
static Int |
Variation of |
static Int |
Variation of |
static Int |
Variation of |
static Int |
Variation of |
static Int |
Variation of |
static Int |
Variation of |
static Int |
Variation of |
static Int |
Variation of |
Constants
TYPE_CLASS_DATETIME
static val TYPE_CLASS_DATETIME: Int
Class for dates and times. It supports the following variations: TYPE_DATETIME_VARIATION_NORMAL
TYPE_DATETIME_VARIATION_DATE
, and TYPE_DATETIME_VARIATION_TIME
.
Value: 4
TYPE_CLASS_NUMBER
static val TYPE_CLASS_NUMBER: Int
Class for numeric text. This class supports the following flags: TYPE_NUMBER_FLAG_SIGNED
and TYPE_NUMBER_FLAG_DECIMAL
. It also supports the following variations: TYPE_NUMBER_VARIATION_NORMAL
and TYPE_NUMBER_VARIATION_PASSWORD
.
IME authors: If you do not recognize the variation, normal should be assumed.
Value: 2
TYPE_CLASS_PHONE
static val TYPE_CLASS_PHONE: Int
Class for a phone number. This class currently supports no variations or flags.
Value: 3
TYPE_CLASS_TEXT
static val TYPE_CLASS_TEXT: Int
Class for normal text. This class supports the following flags (only one of which should be set): TYPE_TEXT_FLAG_CAP_CHARACTERS
, TYPE_TEXT_FLAG_CAP_WORDS
, and. TYPE_TEXT_FLAG_CAP_SENTENCES
. It also supports the following variations: TYPE_TEXT_VARIATION_NORMAL
, and TYPE_TEXT_VARIATION_URI
. If you do not recognize the variation, normal should be assumed.
Value: 1
TYPE_DATETIME_VARIATION_DATE
static val TYPE_DATETIME_VARIATION_DATE: Int
Default variation of TYPE_CLASS_DATETIME
: allows entering only a date.
Value: 16
TYPE_DATETIME_VARIATION_NORMAL
static val TYPE_DATETIME_VARIATION_NORMAL: Int
Default variation of TYPE_CLASS_DATETIME
: allows entering both a date and time.
Value: 0
TYPE_DATETIME_VARIATION_TIME
static val TYPE_DATETIME_VARIATION_TIME: Int
Default variation of TYPE_CLASS_DATETIME
: allows entering only a time.
Value: 32
TYPE_MASK_CLASS
static val TYPE_MASK_CLASS: Int
Mask of bits that determine the overall class of text being given. Currently supported classes are: TYPE_CLASS_TEXT
, TYPE_CLASS_NUMBER
, TYPE_CLASS_PHONE
, TYPE_CLASS_DATETIME
.
IME authors: If the class is not one you understand, assume TYPE_CLASS_TEXT
with NO variation or flags.
Value: 15
TYPE_MASK_FLAGS
static val TYPE_MASK_FLAGS: Int
Mask of bits that provide addition bit flags of options.
Value: 16773120
TYPE_MASK_VARIATION
static val TYPE_MASK_VARIATION: Int
Mask of bits that determine the variation of the base content class.
Value: 4080
TYPE_NULL
static val TYPE_NULL: Int
Special content type for when no explicit type has been specified. This should be interpreted to mean that the target input connection is not rich, it can not process and show things like candidate text nor retrieve the current text, so the input method will need to run in a limited "generate key events" mode, if it supports it. Note that some input methods may not support it, for example a voice-based input method will likely not be able to generate key events even if this flag is set.
Value: 0
TYPE_NUMBER_FLAG_DECIMAL
static val TYPE_NUMBER_FLAG_DECIMAL: Int
Flag of TYPE_CLASS_NUMBER
: the number is decimal, allowing a decimal point to provide fractional values.
Value: 8192
TYPE_NUMBER_FLAG_SIGNED
static val TYPE_NUMBER_FLAG_SIGNED: Int
Flag of TYPE_CLASS_NUMBER
: the number is signed, allowing a positive or negative sign at the start.
Value: 4096
TYPE_NUMBER_VARIATION_NORMAL
static val TYPE_NUMBER_VARIATION_NORMAL: Int
Default variation of TYPE_CLASS_NUMBER
: plain normal numeric text. This was added in android.os.Build.VERSION_CODES#HONEYCOMB
. An IME must target this API version or later to see this input type; if it doesn't, a request for this type will be dropped when passed through EditorInfo.makeCompatible(int)
.
Value: 0
TYPE_NUMBER_VARIATION_PASSWORD
static val TYPE_NUMBER_VARIATION_PASSWORD: Int
Variation of TYPE_CLASS_NUMBER
: entering a numeric password. This was added in android.os.Build.VERSION_CODES#HONEYCOMB
. An IME must target this API version or later to see this input type; if it doesn't, a request for this type will be dropped when passed through EditorInfo.makeCompatible(int)
.
Value: 16
TYPE_TEXT_FLAG_AUTO_COMPLETE
static val TYPE_TEXT_FLAG_AUTO_COMPLETE: Int
Flag for TYPE_CLASS_TEXT
: the text editor (which means the application) is performing auto-completion of the text being entered based on its own semantics, which it will present to the user as they type. This generally means that the input method should not be showing candidates itself, but can expect the editor to supply its own completions/candidates from InputMethodSession.displayCompletions()
as a result of the editor calling InputMethodManager.displayCompletions()
. Note the contrast with TYPE_TEXT_FLAG_AUTO_CORRECT
and TYPE_TEXT_FLAG_NO_SUGGESTIONS
: TYPE_TEXT_FLAG_AUTO_COMPLETE
means the editor should show an interface for displaying suggestions, but instead of supplying its own it will rely on the Editor to pass completions/corrections.
Value: 65536
TYPE_TEXT_FLAG_AUTO_CORRECT
static val TYPE_TEXT_FLAG_AUTO_CORRECT: Int
Flag for TYPE_CLASS_TEXT
: the user is entering free-form text that should have auto-correction applied to it. Without this flag, the IME will not try to correct typos. You should always set this flag unless you really expect users to type non-words in this field, for example to choose a name for a character in a game. Contrast this with TYPE_TEXT_FLAG_AUTO_COMPLETE
and TYPE_TEXT_FLAG_NO_SUGGESTIONS
: TYPE_TEXT_FLAG_AUTO_CORRECT
means that the IME will try to auto-correct typos as the user is typing, but does not define whether the IME offers an interface to show suggestions.
Value: 32768
TYPE_TEXT_FLAG_CAP_CHARACTERS
static val TYPE_TEXT_FLAG_CAP_CHARACTERS: Int
Flag for TYPE_CLASS_TEXT
: capitalize all characters. Overrides TYPE_TEXT_FLAG_CAP_WORDS
and TYPE_TEXT_FLAG_CAP_SENTENCES
. This value is explicitly defined to be the same as TextUtils#CAP_MODE_CHARACTERS
. Of course, this only affects languages where there are upper-case and lower-case letters.
Value: 4096
TYPE_TEXT_FLAG_CAP_SENTENCES
static val TYPE_TEXT_FLAG_CAP_SENTENCES: Int
Flag for TYPE_CLASS_TEXT
: capitalize the first character of each sentence. This value is explicitly defined to be the same as TextUtils#CAP_MODE_SENTENCES
. For example in English it means to capitalize after a period and a space (note that other languages may have different characters for period, or not use spaces, or use different grammatical rules). Of course, this only affects languages where there are upper-case and lower-case letters.
Value: 16384
TYPE_TEXT_FLAG_CAP_WORDS
static val TYPE_TEXT_FLAG_CAP_WORDS: Int
Flag for TYPE_CLASS_TEXT
: capitalize the first character of every word. Overrides TYPE_TEXT_FLAG_CAP_SENTENCES
. This value is explicitly defined to be the same as TextUtils#CAP_MODE_WORDS
. Of course, this only affects languages where there are upper-case and lower-case letters.
Value: 8192
TYPE_TEXT_FLAG_ENABLE_TEXT_CONVERSION_SUGGESTIONS
static val TYPE_TEXT_FLAG_ENABLE_TEXT_CONVERSION_SUGGESTIONS: Int
Flag for TYPE_CLASS_TEXT
: Let the IME know the text conversion suggestions are required by the application. Text conversion suggestion is for the transliteration languages which has pronunciation characters and target characters. When the user is typing the pronunciation charactes, the IME could provide the possible target characters to the user. When this flag is set, the IME should insert the text conversion suggestions through Builder#setTextConversionSuggestions(List)
and the TextAttribute
with initialized with the text conversion suggestions is provided by the IME to the application. To receive the additional information, the application needs to implement InputConnection#setComposingText(CharSequence, int, TextAttribute)
, InputConnection#setComposingRegion(int, int, TextAttribute)
, and InputConnection#commitText(CharSequence, int, TextAttribute)
.
Value: 1048576
TYPE_TEXT_FLAG_IME_MULTI_LINE
static val TYPE_TEXT_FLAG_IME_MULTI_LINE: Int
Flag for TYPE_CLASS_TEXT
: the regular text view associated with this should not be multi-line, but when a fullscreen input method is providing text it should use multiple lines if it can.
Value: 262144
TYPE_TEXT_FLAG_MULTI_LINE
static val TYPE_TEXT_FLAG_MULTI_LINE: Int
Flag for TYPE_CLASS_TEXT
: multiple lines of text can be entered into the field. If this flag is not set, the text field will be constrained to a single line. The IME may also choose not to display an enter key when this flag is not set, as there should be no need to create new lines.
Value: 131072
TYPE_TEXT_FLAG_NO_SUGGESTIONS
static val TYPE_TEXT_FLAG_NO_SUGGESTIONS: Int
Flag for TYPE_CLASS_TEXT
: the input method does not need to display any dictionary-based candidates. This is useful for text views that do not contain words from the language and do not benefit from any dictionary-based completions or corrections. It overrides the TYPE_TEXT_FLAG_AUTO_CORRECT
value when set. Please avoid using this unless you are certain this is what you want. Many input methods need suggestions to work well, for example the ones based on gesture typing. Consider clearing TYPE_TEXT_FLAG_AUTO_CORRECT
instead if you just do not want the IME to correct typos. Note the contrast with TYPE_TEXT_FLAG_AUTO_CORRECT
and TYPE_TEXT_FLAG_AUTO_COMPLETE
: TYPE_TEXT_FLAG_NO_SUGGESTIONS
means the IME does not need to show an interface to display suggestions. Most IMEs will also take this to mean they do not need to try to auto-correct what the user is typing.
Value: 524288
TYPE_TEXT_VARIATION_EMAIL_ADDRESS
static val TYPE_TEXT_VARIATION_EMAIL_ADDRESS: Int
Variation of TYPE_CLASS_TEXT
: entering an e-mail address.
Value: 32
TYPE_TEXT_VARIATION_EMAIL_SUBJECT
static val TYPE_TEXT_VARIATION_EMAIL_SUBJECT: Int
Variation of TYPE_CLASS_TEXT
: entering the subject line of an e-mail.
Value: 48
TYPE_TEXT_VARIATION_FILTER
static val TYPE_TEXT_VARIATION_FILTER: Int
Variation of TYPE_CLASS_TEXT
: entering text to filter contents of a list etc.
Value: 176
TYPE_TEXT_VARIATION_LONG_MESSAGE
static val TYPE_TEXT_VARIATION_LONG_MESSAGE: Int
Variation of TYPE_CLASS_TEXT
: entering the content of a long, possibly formal message such as the body of an e-mail.
Value: 80
TYPE_TEXT_VARIATION_NORMAL
static val TYPE_TEXT_VARIATION_NORMAL: Int
Default variation of TYPE_CLASS_TEXT
: plain old normal text.
Value: 0
TYPE_TEXT_VARIATION_PASSWORD
static val TYPE_TEXT_VARIATION_PASSWORD: Int
Variation of TYPE_CLASS_TEXT
: entering a password.
Value: 128
TYPE_TEXT_VARIATION_PERSON_NAME
static val TYPE_TEXT_VARIATION_PERSON_NAME: Int
Variation of TYPE_CLASS_TEXT
: entering the name of a person.
Value: 96
TYPE_TEXT_VARIATION_PHONETIC
static val TYPE_TEXT_VARIATION_PHONETIC: Int
Variation of TYPE_CLASS_TEXT
: entering text for phonetic pronunciation, such as a phonetic name field in contacts. This is mostly useful for languages where one spelling may have several phonetic readings, like Japanese.
Value: 192
TYPE_TEXT_VARIATION_POSTAL_ADDRESS
static val TYPE_TEXT_VARIATION_POSTAL_ADDRESS: Int
Variation of TYPE_CLASS_TEXT
: entering a postal mailing address.
Value: 112
TYPE_TEXT_VARIATION_SHORT_MESSAGE
static val TYPE_TEXT_VARIATION_SHORT_MESSAGE: Int
Variation of TYPE_CLASS_TEXT
: entering a short, possibly informal message such as an instant message or a text message.
Value: 64
TYPE_TEXT_VARIATION_URI
static val TYPE_TEXT_VARIATION_URI: Int
Variation of TYPE_CLASS_TEXT
: entering a URI.
Value: 16
TYPE_TEXT_VARIATION_VISIBLE_PASSWORD
static val TYPE_TEXT_VARIATION_VISIBLE_PASSWORD: Int
Variation of TYPE_CLASS_TEXT
: entering a password, which should be visible to the user.
Value: 144
TYPE_TEXT_VARIATION_WEB_EDIT_TEXT
static val TYPE_TEXT_VARIATION_WEB_EDIT_TEXT: Int
Variation of TYPE_CLASS_TEXT
: entering text inside of a web form.
Value: 160
TYPE_TEXT_VARIATION_WEB_EMAIL_ADDRESS
static val TYPE_TEXT_VARIATION_WEB_EMAIL_ADDRESS: Int
Variation of TYPE_CLASS_TEXT
: entering e-mail address inside of a web form. This was added in android.os.Build.VERSION_CODES#HONEYCOMB
. An IME must target this API version or later to see this input type; if it doesn't, a request for this type will be seen as TYPE_TEXT_VARIATION_EMAIL_ADDRESS
when passed through EditorInfo.makeCompatible(int)
.
Value: 208
TYPE_TEXT_VARIATION_WEB_PASSWORD
static val TYPE_TEXT_VARIATION_WEB_PASSWORD: Int
Variation of TYPE_CLASS_TEXT
: entering password inside of a web form. This was added in android.os.Build.VERSION_CODES#HONEYCOMB
. An IME must target this API version or later to see this input type; if it doesn't, a request for this type will be seen as TYPE_TEXT_VARIATION_PASSWORD
when passed through EditorInfo.makeCompatible(int)
.
Value: 224