Enumeration
GtkInputPurpose
Description [src]
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”.
Members
| Name | Description | 
|---|---|
| GTK_INPUT_PURPOSE_FREE_FORM | Allow any character. | 
| GTK_INPUT_PURPOSE_ALPHA | Allow only alphabetic characters. | 
| GTK_INPUT_PURPOSE_DIGITS | Allow only digits. | 
| GTK_INPUT_PURPOSE_NUMBER | Edited field expects numbers. | 
| GTK_INPUT_PURPOSE_PHONE | Edited field expects phone number. | 
| GTK_INPUT_PURPOSE_URL | Edited field expects URL. | 
| GTK_INPUT_PURPOSE_EMAIL | Edited field expects email address. | 
| GTK_INPUT_PURPOSE_NAME | Edited field expects the name of a person. | 
| GTK_INPUT_PURPOSE_PASSWORD | Like  | 
| GTK_INPUT_PURPOSE_PIN | Like  | 
| GTK_INPUT_PURPOSE_TERMINAL | Allow any character, in addition to control codes. |