Gtk.InputPurpose
Describes primary purpose of the input widget. This information is useful for on-screen keyboards and similar input methods to decide which keys should be presented to the user.
Note that the purpose is not meant to impose a totally strict rule about allowed characters, and does not replace input validation. It is fine for an on-screen keyboard to let the user override the character set restriction that is expressed by the purpose. The application is expected to validate the entry contents, even if it specified a purpose.
The difference between @GTK_INPUT_PURPOSE_DIGITS and @GTK_INPUT_PURPOSE_NUMBER is that the former accepts only digits while the latter also some punctuation (like commas or points, plus, minus) and 'e' or 'E' as in 3.14E+000.
This enumeration may be extended in the future; input methods should interpret unknown values as 'free form'.
Since 3.6
- InputPurpose.FREE_FORM
Allow any character
- InputPurpose.ALPHA
Allow only alphabetic characters
- InputPurpose.DIGITS
Allow only digits
- InputPurpose.NUMBER
Edited field expects numbers
- InputPurpose.PHONE
Edited field expects phone number
- InputPurpose.URL
Edited field expects URL
- InputPurpose.EMAIL
Edited field expects email address
- InputPurpose.NAME
Edited field expects the name of a person
- InputPurpose.PASSWORD
Like @GTK_INPUT_PURPOSE_FREE_FORM, but characters are hidden
- InputPurpose.PIN
Like @GTK_INPUT_PURPOSE_DIGITS, but characters are hidden