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
GTK_INPUT_PURPOSE_FREE_FORM-
Allow any character.
- Value:
0 - Nickname:
free-form - Available since: 4.0
- Value:
GTK_INPUT_PURPOSE_ALPHA-
Allow only alphabetic characters.
- Value:
1 - Nickname:
alpha - Available since: 4.0
- Value:
GTK_INPUT_PURPOSE_DIGITS-
Allow only digits.
- Value:
2 - Nickname:
digits - Available since: 4.0
- Value:
GTK_INPUT_PURPOSE_NUMBER-
Edited field expects numbers.
- Value:
3 - Nickname:
number - Available since: 4.0
- Value:
GTK_INPUT_PURPOSE_PHONE-
Edited field expects phone number.
- Value:
4 - Nickname:
phone - Available since: 4.0
- Value:
GTK_INPUT_PURPOSE_URL-
Edited field expects URL.
- Value:
5 - Nickname:
url - Available since: 4.0
- Value:
GTK_INPUT_PURPOSE_EMAIL-
Edited field expects email address.
- Value:
6 - Nickname:
email - Available since: 4.0
- Value:
GTK_INPUT_PURPOSE_NAME-
Edited field expects the name of a person.
- Value:
7 - Nickname:
name - Available since: 4.0
- Value:
GTK_INPUT_PURPOSE_PASSWORD-
Like
GTK_INPUT_PURPOSE_FREE_FORM, but characters are hidden.- Value:
8 - Nickname:
password - Available since: 4.0
- Value:
GTK_INPUT_PURPOSE_PIN-
Like
GTK_INPUT_PURPOSE_DIGITS, but characters are hidden.- Value:
9 - Nickname:
pin - Available since: 4.0
- Value:
GTK_INPUT_PURPOSE_TERMINAL-
Allow any character, in addition to control codes.
- Value:
10 - Nickname:
terminal - Available since: 4.0
- Value: