GtkInputPurpose

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'. 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_FREE_FORM, but characters are hidden GTK_INPUT_PURPOSE_PIN Like GTK_INPUT_PURPOSE_DIGITS, but characters are hidden Since 3.6