虚拟方法

GtkWidgetkeynav_failed

声明 [源代码]

gboolean
keynav_failed (
  GtkWidget* widget,
  GtkDirectionType direction
)

描述 [源代码]

在票价上发出Gtk.Widget::keynav-failed信号。

每当单个小部件内的键盘导航遇到边界时,应该调用此函数。

此函数的返回值应该类似于gtk_widget_child_focus()的返回值。如果返回true,则留在小部件中,失败的键盘导航是正常的,或者没有地方可以/应该移动焦点。如果返回false,则调用方应该继续在小部件外进行键盘导航,例如通过在小部件的最顶层调用gtk_widget_child_focus()

默认的Gtk.Widget::keynav-failed处理程序对GTK_DIR_TAB_FORWARDGTK_DIR_TAB_BACKWARD返回false。对于GtkDirectionType的其他值,返回true。

默认处理程序返回true时,它还调用gtk_widget_error_bell()来通知用户失败的键盘导航。

提供自己的::keynav-failed实现(通过连接到它或覆盖它)的一个用例是GtkEntry小部件的行,用户应该能够使用箭头键遍历整个行,例如,从需要输入许可证密钥的用户界面中熟知。

参数

方向

类型: GtkDirectionType

焦点移动方向。

返回值

类型: gboolean

如果停止键盘导航是可以接受的,则为真;如果发出该控件的父控件应该试图处理键盘导航尝试,则为假。