Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit d3badad3 authored by Kenny Root's avatar Kenny Root
Browse files

Clarify use of InputType flags 

Some developers were confused about how to use the inputType field
and were omitting the class type when setting variations.

There are places in the framework where it specifically checks for
a class and variation before it invokes the desired behavior.

For instance, in EditText when setting the input type to a visible
password, it specifically checks for this condition:
inputType == (TYPE_CLASS_TEXT | TYPE_TEXT_VARIATION_VISIBLE_PASSWORD)
parent 8ecb36ee

core/java/android/text/InputType.java

+19 −1
Original line number Diff line number Diff line
@@ -20,7 +20,25 @@ import android.text.TextUtils; 


/**

 * Bit definitions for an integer defining the basic content type of text

 * held in an {@link Editable} object.

 * held in an {@link Editable} object. Supported classes may be combined

 * with variations and flags to indicate desired behaviors.

 *

 * <h3>Examples</h3>

 *

 * <dl>

 * <dt>A password field with with the password visible to the user:

 * <dd>inputType = TYPE_CLASS_TEXT |

 *     TYPE_TEXT_VARIATION_VISIBLE_PASSWORD

 *

 * <dt>A multi-line postal address with automatic capitalization:

 * <dd>inputType = TYPE_CLASS_TEXT |

 *     TYPE_TEXT_VARIATION_POSTAL_ADDRESS |

 *     TYPE_TEXT_FLAG_MULTI_LINE

 *

 * <dt>A time field:

 * <dd>inputType = TYPE_CLASS_DATETIME |

 *     TYPE_DATETIME_VARIATION_TIME

 * </dl>

 */

public interface InputType {

    /**