Package: gtk

GEnum gtk-input-purpose

Details

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 the :digits and :number values 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'.
(define-g-enum "GtkInputPurpose" gtk-input-purpose
  (:export t
   :type-initializer "gtk_input_purpose_get_type")
  (:free-form 0)
  (:alpha 1)
  (:digits 2)
  (:number 3)
  (:phone 4)
  (:url 5)
  (:email 6)
  (:name 7)
  (:password 8)
  (:pin 9))  
:free-form
Allow any character.
:alpha
Allow only alphabetic characters.
:digits
Allow only digits.
:number
Edited field expects numbers.
:phone
Edited field expects phone number.
:url
Edited field expects URL.
:email
Edited field expects email address.
:name
Edited field expects the name of a person.
:password
Like :free-form, but characters are hidden.
:pin
Like :digits, but characters are hidden.
 

See also

2021-11-2