Input Filter Plus

an InputFilter which offers a vast array of callbacks in place of InputFilter#filter

Classes

Class Name	Class Description
InputFilterPlus	the core class, where all the hard work is done
BackSpaceFilter	a version of InputFilterPlus that can disallow backspaces
ReplacementFilter	a version of InputFilterPlus that can replace text
SpaceFilter	a version of InputFilterPlus that can disallow spaces. this is actually just a wrapper around ReplacementFilter
AlphaNumericRangeFilter	a version of InputFilterPlus that limits text to an alphanumeric range (0... 9... and A... to Z...), supports both lowercase and UPPERCASE letters
AlphabeticalRangeFilter	a version of InputFilterPlus that limits text to an alphabetical range (A... Z...)
NumericRangeFilter	a version of InputFilterPlus that limits text to a numerical range (0... 9...)
HexRangeFilter	a version of InputFilterPlus that limits text to a hexadecimal range (0... 9... and A... to F...), supports both lowercase and UPPERCASE letters

Callback return values

Return value	Meaning
PROCESSES_MODE_APPEND_ORIGINAL	return this if you want to append/replace with the original value
PROCESSES_MODE_APPEND_NOTHING	return this if you want to reject the append/replacement all together
String	return anything of type String if you want to append/replace with a custom string

the default return value for all callbacks in InputFilterPlus is PROCESSES_MODE_APPEND_ORIGINAL

Callbacks

setText

• set text

Append

• appended letter (start)
• appended letter (middle)
• appended letter (end)

Remove

• removed letter (start)

• removed letter (middle)

• removed letter (end)

• removed string (start)

• removed string (middle)

• removed string (end)

Replace

• replaced letter (start)

• replaced letter (middle)

• replaced letter (end)

• replaced string (start)

• replaced string (middle)

• replaced string (end)

Paste

• pasted string (start)
• pasted string (middle)
• pasted string (end)

Notes

Note

for some unknown reason, the

• select text, and then press space (on the IME/soft keyboard)

is interpreted not as a single InputFilter#filter event:

• replaced string

but instead as two sequential InputFilter#filter events:

• removed string

followed by

• appended letter

Note

since pasting text, and glide/swipe text input, emit the same functionality, it is impossible to distinguish between the two

for example:

• glide/swipe : source = [focus], start = [0], end = [5], dest = [lll], dstart = [2], dend = [2]
• paste : source = [focus], start = [0], end = [5], dest = [lll], dstart = [2], dend = [2]

for this reason it is also impossible to append a string since this functionality is equivalent to paste string

this is also true for the following:

• remove string and cut string
• append letter and paste letter
• set Text and paste string ONLY when the text field is first modified, subsequent modifications to the text field will trigger set Text callback