枚举

GtkInputPurpose

声明

enum Gtk.InputPurpose

描述 [src]

描述输入小组件的主要用途。

此信息对于屏幕键盘和类似输入法很有用,以便决定向用户显示哪些键。

请注意,此用途并非旨在对允许的字符施加严格规则,并且不会取代输入验证。屏幕键盘允许用户覆盖由用途表示的字符集限制是可以的。应用程序应验证输入内容,即使它指定了用途。

GTK_INPUT_PURPOSE_DIGITSGTK_INPUT_PURPOSE_NUMBER 的区别在于,前者只接受数字,而后者还接受一些标点符号(如逗号、圆点、加号、减号)和“e”或“E”,比如 3.14E+000。

此枚举将来可能会扩展;输入法应将未知值解释为“自由格式”。

成员

GTK_INPUT_PURPOSE_FREE_FORM

允许任何字符。

  • 值: 0
  • 从以下版本开始提供: 4.0
GTK_INPUT_PURPOSE_ALPHA

仅允许字母字符。

  • 值: 1
  • 从以下版本开始提供: 4.0
GTK_INPUT_PURPOSE_DIGITS

仅允许数字。

  • 值: 2
  • 从以下版本开始提供: 4.0
GTK_INPUT_PURPOSE_NUMBER

编辑字段预期为数字。

  • 值: 3
  • 从以下版本开始提供: 4.0
GTK_INPUT_PURPOSE_PHONE

编辑字段预期为电话号码。

  • 值: 4
  • 从以下版本开始提供: 4.0
GTK_INPUT_PURPOSE_URL

编辑字段预期为 URL

  • 值: 5
  • 从以下版本开始提供: 4.0
GTK_INPUT_PURPOSE_EMAIL

编辑字段预期为电子邮件地址。

  • 值: 6
  • 从以下版本开始提供: 4.0
GTK_INPUT_PURPOSE_NAME

编辑字段预期为某人的姓名。

  • 值: 7
  • 从以下版本开始提供: 4.0
GTK_INPUT_PURPOSE_PASSWORD

类似于 GTK_INPUT_PURPOSE_FREE_FORM,但字符被隐藏。

  • 值: 8
  • 从以下版本开始提供: 4.0
GTK_INPUT_PURPOSE_PIN

类似于 GTK_INPUT_PURPOSE_DIGITS,但字符被隐藏。

  • 值: 9
  • 从以下版本开始提供: 4.0
GTK_INPUT_PURPOSE_TERMINAL

除了控制代码,还允许使用任何字符。

  • 值: 10
  • 从以下版本开始提供: 4.0